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TUtti la chiedono. Ecco le cose da conoscere 
per non farti trovare impreparato 

TEORIA Mai più dubbi su Tv On Demand, 
Broadcasting, larghezza di banda 
e compressione 

STRUMENTI Windows Media 
SDK, Encoder e Media Services. 
Impara ad usarli! 

PRATICA Crea una trasmissione 
aggiungi la pubblicità e gestisci 
lo streaming 

CODICE Un'applicazione completa 
e personalizzata in Visual Basic 
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USALO COSI! 

Rendi tutto velocissimo con le Stored 
Procedure, automatizza il lavoro con i Jobs f 
crea DLL in .NET e registrale nel database! 



CASI DI STUDIO: SOLUZIONI PER LA TELEFONIA MOBILE 



SALVA I DATI SUL CELLULARE 

Impara le tecniche per conservare testi e immagini sul telefonino e crea 
un software per consultare i titoli della tua videoteca lontano dal PC 



INTERNET 



PHP SOTTO STEROIDI 

Compila gli script, salvali in una cache 
e raddoppia la velocità dei tuoi siti 



lALBERI 



SISTEMA 



THREAD? FACILE CON .NET 

Scopri il BackGroundWorker e usalo 

per far lavorare insieme due o più processi 



_3J Dalla ricerca alla ricorsione, ti spieghiamo 
come funzionano gli algoritmi fondamentali! 



UN MONITOR PER 
LE APPLICAZIONI 

Usa JMX per interrogare 
il tuo software. Funziona 
anche da remoto 

COSTRUIAMO 
UN FILE DI HELP 

Premi il tasto F1 e visualizza 
l'aiuto in linea, completo 
di indice e ricerca! 



DATI IN VISTA 
QUASI COME EXCEL 

Arriva la nuova DataGridView 
di .NET 2.0, ecco come 
sfruttarne tutte le potenzialità 

PROGRAMMA 
MSN MESSENGER 

Integralo nelle applicazioni 
e usalo per scambiare 
informazioni in tempo reale 

INSTALLAZIONI 
SEMPLIFICATE 

Risolvi ogni problema di 
upgrade e di distribuzione 
con ClickOnce 



SIN PIÙ LA VIDEOGUIDA NEL CD 



WORKFLOW 

FOUNDATION 

HOWTO 

Disegna il comportamento 
della tua applicazione, il 
codice arriva in automatico... 



SIN PIÙ LA VIDEOGUIDA NEL CD 



ADDIO PROBLEMI 
CON I TIPI 

Impara ad usare i Generics: 
una delle novità più importanti 
del framework 2.0 
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▼ Direzione TV 



Tutti si interrogano: qual è il futuro di Internet? 
qual è il futuro della programmazione? La verità 
è che soprattutto Internet emana un fascino fuori 
dal comune nei confronti di chi la utilizza ed in par- 
ticolare nei confronti di chi è appassionato di tec- 
nologia. L'evoluzione della rete è chiara, si è passati 
dalla magnificazione dei contenuti, al boom dell'e- 
commerce, alla democrazia dei blog. Per ciascuno 
di questi "strati temporali" si è vissuto almeno un 
momento di esaltazione comunitaria, in cui la rivo- 
luzione portata della rete avrebbe potuto cambiare 
le sorti economico /sociali del nostro mondo. E per 
quanto gli scettici rimangano dubbiosi, è percepibi- 
le quanto Internet, intesa come insieme dei suoi 
servizi, sia ormai presente nella nostra vita quoti- 
diana e quanto giornalmente incida sulle nostre 
attività. Siamo dunque ad una nuova frontiera, 
quella della Televisione over IP. Anche questa volta 
come sempre si grida alla rivoluzione, ed anche 
questa volta come sempre non resteremo delusi. 
■£H4tJ* M1I1IM Orto chi si aspetta che dall'oggi al domani l'au- 

j|ffBmiWÌP dience delle televisioni tradizionali venga intaccato 

dalla televisione via Internet, rimarrà deluso. La 



Segreteria di Redazione: Veronica Longo 

Realizzazione grafica: Cromatika S.r.l. 

Art Director: Paolo Cristiano 

Coordinamento tecnico: Giancarlo Sicilia 

Illustrazioni: M. Veltri 

ìazione elettronica: Elio M"-" r 



Via C. Correnti, 1 - 20123 Milano 
Tel. 02 831212 - Fax 02 83121207 



Tel. 02 831213 - Fax 02 83121330 
Sede di Rende: C.da Lecco, zona industriale - 87036 Rende (CS) 



ABBONAMENTO E ARRETRATI 
ITALIA: Abbonamento Annuale: ioProgrammo (11 numeri) €59,90 

i 20% sul f 
Libro (11 numeri) €75,90 sconto 30% sul prezzo di copertina di 
€108,90 



dovrà essere inviata via fax allo 02 83121206, oppure via posta a EDI- 
ZIONI MASTER via C. Correnti, 1 - 20123 Milano, dopo avere effettuato 
il pagamento, secondo le modalità di seguito elencate: 

• cc/p n.16821878 o vaglia postale (inviando copia della ricevuta del 



• assegno bancario non trasferibile (da inviarsi in busta chiusa insieme 
"i richiesta); 

• carta di credito, circuito VISA, CARTASI', MASTERCARD/EUROCARD, (in- 



• bonifico bancario intestato a Edizioni Master S.p.A. c/o Banca Credem 
S.p.a. c/c 01 000 000 5000 ABI 03032 CAB 80880 CIN Q (inviando copia 
della distinta insieme alla richiesta). 

SI PREGA DI UTILIZZARE IL MODULO RICHIESTA ABBONAMENTO POSTO 



televisione over IP entrerà nelle nostre abitudini di 
vita, così come ha fatto la posta elettronica, così 
come ha fatto l' ecommerce, così come continuano 
a fare i blog, lo farà con discrezione come solo 
Internet è abituata a fare. Noi programmatori ci tro- 
viamo di fronte ad una nuova sfida, dopo avere 
creato il web dinamico, dopo avere automatizzato 
la pubblicazione di contenuti testuali, dopo avere 
inventato i mezzi per consentire a chiunque di 
avere una voce su Internet, siamo adesso al 
momento in cui dovremo essere capaci di automa- 
tizzare la pubblicazione di Video. Lo faremo, come 
sempre, stando attenti ai particolari e aiutando la 
tecnologia a crescere. Lo faremo pensando all'otti- 
mizzazione della banda, alla veicolazione della pub- 
blicità, all'interattività con l'utente, alla raccolta dei 
log, e infine pensando ai contenuti On Demand e 
alla loro commercializzazione. Un anno importante 
ci attende in questo settore, la nuova sfida si gioca 
sui servizi, e la TV via Internet può essere uno dei 
centri proprio per l'erogazione di tutti quei servizi 
che solo noi sappiamo programmare! 

Fabio Farnesi ffarnesi@edmaster. it 




All'inizio di ogni articolo, troverete un simbolo 
che indicherà la presenza di codice e/o software 
allegato, che saranno presenti sia sul CD (nella 
posizione di sempre \soft\codice\ e \soft\tools\) 
sia sul Web, all'indirizzo 
http://cdrom.ioprogrammo.it. 
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• TEORIA Mai più dubbi su Tv On 
Demand, Broadcasting, larghezza 
di banda e compressione 
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• STRUMENTI Windows Media 
SDK, Encoder e Media 
Services. Impara come usarli! 

• PRATICA Crea una trasmissione 
aggiungi la pubblicità e gestisci lo streaming 

• CODICE Un'applicazione completa 
e personalizzata in Visual Basic 
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Questo mese su ioProgrammo 



SQL SERVER 



II 



USALO COSI! 



Rendi tutto velocissimo con le stored procedure, automatizza il 
lavoro con i Jobs, crea DLL in .NET e registrale nel database 

pag. 24 



IOPROGRAMMO WEB 



PHP alla ricerca delle prestazioni . . . 
pag. 24 

In questo aricolo impareremo alcune cose 
sui meccanismi interni di funzionamento di 
PHP e utilizzeremo un'estensione che rad- 
doppia la velocità di esecuzione degli 
script! pronti, partenza... via 



DATABASE 



Alla scoperta del datagridview . . 
pag. 28 

// .Net Framework 2.0 ha introdotto il 
controllo datagridview per la 
presentazione di dati in forma tabellare, 
un notevole passo avanti rispetto al 
vecchio datagrid 



NETWORKING 



Instant messaging con MSN e .Net 
pag. 40 

Dotmsn è una libreria open source per uti- 
lizzare le funzionalità di MSN messenger in 
una qualunque applicazione .Net sia 
Windows che Web vediamo come dotare il 
nostro sftaware di una chat one to one 




SISTEMA 



Istallazioni in un click(once)pag. 64 

Utilizziamo una delle ultime tecnologie 
di casa Microsoft per distribuire in modo 
efficace le nostre applicazioni senza 
doverci preoccupare di futuri 
aggiornamenti e dell'omogeneità delle 
versioni installate 

Programmiamo il tasto "FI" . pag. 72 

In questo articolo sfruttiamo i tool di 
sun: Javahelp per costruire un sistema di 
documentazione efficace per le nostre 
applicazioni, vedremo come gestire 
l'albero degli argomenti e come 
crearecollegamenti opportuni 

Windows workf low foundation 
pag. 76 

Ogni applicazione, piccola o grande che 
sia, implementa un workf low. In questo 
articolo scopriremo come creare 
workflow, anche complessi, con la nuova 
tecnologia Microsoft nata per gestire 
facilmente i flussi 



SISTEMA 



Creare applicazioni 
servite oriented 

pag. 82 

Comunicazione ed 
interoperabilità sono le parole 
chiave del futuro. Vediamo 
una delle soluzioni Microsoft 



Processi asincroni con facilità 
pag. 86 

Facciamo conoscenza con 
"Backgroundworker" un componente 
presente in Visual studio 2005, che 
semplifica enormemente la vita al 
programmatore mettendogli a 
disposizione meccanismi automatizzati 
per la gestione 



DATABASE 



Impariamo a usare le stored 
procedures pag. 90 

Ecco come possiamo accelerare le 
prestazioni del database memorizzando 
le query direttamente sul server, e 
lasciando al data base il compito di 
gestire al meglio 

Facciamo fare il "lavoro" a SQL 
server pag. 96 

Alla scoperta di una delle funzionalità 
avanzate del nuovo prodotto di 
Microsoft. Scopriremo come con poco 



RUBRICHE 



Gli allegati di ioProgrammo 

// software in allegato alla rivista 



pag. 6 



Il libro di ioProgrammo pag. 7 

// contenuto del libro in allegato alla rivista 

News pag. 12 

Le più importanti novità del mondo 
della programmazione 

ioProgrammo by Example pag. 29 

4 problemi risolti con gli esempi di codice rapido 
da copiare e incollare per tutti i linguaggi 

Software pag. 106 

/ contenuti del CD allegato ad ioProgrammo. 
Corredati spesso di tutorial e guida all'uso 



sforzo sia possibile far compiere 
direttamente al DB operazioni ripetitive 



SISTEMA 



Le classi ed i metodi generici 
pag. 100 

/ generics son una nuova 
caratteristicainteressante di Visual Basic 
.Net 2005, permettono di rendere il 
proprio codice veloce, conciso e più 
elegante. Sfruttiamolo a fondo 



SOLUZIONI 



Alberi di ricerca pag. 110 

La struttura dati albero è una delle più 
importanti nel panorama della 
programmazione. Imparare a manipolare 
le funzioni di base è lo scopo del 
presente articolo 



ioProgrammo by EXAMPLE 



.NET& PHP 

Come posso ridimensionare un'immagine? 

30 

Come posso estrarre il contenuto 

di un file zip? 33 

Come posso usare Acces come client di SQL 

Server 2005? 37 

Come posso scrivere una stored procedure 
in managed code? 38 



QUALCHE CONSIGLIO UTILE 

I nostri articoli si sforzano di essere 
comprensibili a tutti coloro che ci 
seguono. Nel caso in cui abbiate 
difficoltà nel comprendere esattamente 
il senso di una spiegazione tecnica, è 
utile aprire il codice allegato all'articolo 
e seguire passo passo quanto viene 
spiegato tenendo d'occhio l'intero 
progetto. Spesso per questioni di spazio 
non possiamo inserire il codice nella 
sua interezza nel corpo dell'articolo. Ci 
limitiamo a inserire le parti necessarie 
alla stretta comprensione della tecnica. 
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Le versioni di ioProgrammo 




rivista + 2 cd-rom in edicola 



Prodotti del mese 



Microsoft SQL 
2005 Server 
Express Edition 

Per la prima volta In versione 
gratuita, arriva II DB per le aziende 

Microsoft SQL server 2005 è la nuova 
versione del database progettato da 
Microsoft per rispondere alle esigenze 
di tipo professionale. Le novità intro- 
dotte sono veramente moltissime. Pri- 
ma fra tutte spicca il nuovo formato fi- 
le: "MDF". I dati possono essere salva- 
ti in un file esterno, con estensione MDF. 
Questo approccio, molto simile a quel- 
lo usato da Access con i suoi MDB, ren- 
de incredibilmente elevata la portabilità 
da una macchina all'altra. Ulteriori no- 
vità importanti sono state introdotte 
come ad esempio i Service Broker, che 
consentono di salvare i dati in una co- 
da del SQL Server locale ed effettuare 
un update sul server remoto in modo au- 
tomatico alla prima disponibilità della 
connettività, e ancora gli Integration 
Services grazie ai quali è possibile migrare 
da qualunque database esterno anche 
proprietario a SQL Server 

[pag.106] 
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Ajax For .NET 

Il framework per creare 
applicazioni AJAX In ambiente 
Microsoft 

Ajax è una tecnologia che si sta 
rapidamente affermando nel 
campo delle WEB Application. 
Consente di realizzare pagine 
web dinamiche in grado di ag- 
giornare solo le parti variabili 
della pagina senza doverla rica- 
ricare interamente. 
Ovviamente questo comporta 
un vantaggio immediato in ter- 
mini di usabilità delle applicazio- 
ni, tale che le web application 
possono assumere il comporta- 
mento tipico in termini di inter- 
faccia, di un'applicazione stan- 
dalone. Grazie a questo genere 
di possibilità il Web sta rapida- 
mente migrando concentrandosi 
sull'erogazione di servizi all'u- 
tente finale, basati su interfacce 
che fino a qualche anno fa sem- 
bravano impossibili per la rete 
internet 

[pag.107] 
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AXIS1.3 

Il framework per lo sviluppo di 
Web Service In Java 

Che i Web Service rappresentino 
una risorsa enorme per la program- 
mazione è ormai noto, in questo 
stesso numero di ioProgrammo 
diamo enorme spazio all'argomen- 
to proprio con una serie di esempi 
pratici per lo sviluppo. Mancano 
dai nostri esempi proprio quelli re- 
lativi a Java di cui ci occuperemo 
nei numeri successivi della rivista. 
Axis è comunque il tool fondamen- 
tale per poter sviluppare WS con il 
linguaggio di SUN. Il suo utilizzo è 
abbastanza semplice, e supporta 
tutte le caratteristiche avanzate co- 
me ad esempio la generazione di- 
namica dei WSDL oppure il de- 
bugging delle trasmissioni SOAP 
Lavora in congiunzione stretta con 
Tomcat e il suo deployment si ridu- 
ce a copiare i file nella directory 
corretta.. Uno strumento indispen- 
sabile di cui non mancheremo di 
parlare ulteriormente. 

[pag.106] 
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Hibernate 3.2.0 

Il tool per la persistenza del dati 
In JAVA 

I programmatori sono abituati a 
pensare in termini di classi ed 
oggetti. Non c'è programma che 
prescinda ormai dalla logica della 
programmazione OOP. Tuttavia i 
database SQL ragionano ancora in 
termini di puro linguaggio, non 
c'è nessuna correlazione fra un 
dato e l'oggetto che lo rappresen- 
ta. Hibernate aggira questo osta- 
colo, ponendosi come framework 
che maschera un database relazio- 
nale con una logica OOP. 
In questo modo i programmatori 
Java possono ad esempio accede- 
re a un qualunque database pen- 
sando alle righe e alle colonne che 
lo rappresentano in termini di og- 
getti e non di entità relazionali, 
con evidenti vantaggi in termini di 
sviluppo omogeneo. Quella che vi 
presentiamo in questo numero è 
la versione più aggiornata del 
tool, più veloce e affidabile. 

[pag.108] 
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VISUAL 




I contenuti del libro 



Imparare VISUAL BASIC .MET 



Visual basic è uno di quei Linguaggi che hanno 
cambiato il modo di intendere la 
programmazione nel corso del tempo. 
Fin dalla sua prima uscita, grazie al concetto di RAD 
e di programmazione ad eventi ha conquistato il 
cuore di milioni di programmatori in tutto il mondo, 
tanto che attualmente è sicuramente fra i linguaggi 
più utilizzati dalle aziende e dai singoli team di 
sviluppo. 

La naturale evoluzione di Visual Basic nel modello 
.NET segna un ulteriore importante passo nello 
sviluppo di questo linguaggio. "Imparare VB.NET" si 
pone come un manuale pratico, che prescinde da una 
conoscenza approfondita delle versioni precedenti di 
Visual Basic, e che porta anche l'utente più 
inesperto, in breve tempo a poter costruire 
applicazioni complete. 



PROGRAMMA SUBITO 

CON IL LINGUAGGIO 

PIÙ UTILIZZATO AL MONDO 

■ Gli elementi di base 

■ Istruzioni e flussi di codice 

■ Gli oggetti e le classi 

■ Il .NET Framework 
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VISUAL STUDIO 2005 

UN BUON MOTIVO PER SVILUPPARE 
CON TECNOLOGIA .NET 

MICROSOFT HA RILASCIATO LO SCORSO NOVEMBRE LA NUOVA VERSIONE 2005 
DI VISUAL STUDIO, LO STRUMENTO DI SVILUPPO PIÙ COMPLETO PER REALIZZARE 
APPLICAZIONI PER WINDOWS, PER IL WEB, WEB SERVICE E DISPOSITIVI MOBILI 



Dal 1° marzo 2006, il prodotto è 
disponibile per il mercato anche in 
lingua italiana: interfaccia utente 
(menù e barra degli strumenti), documen- 
tazione (MSDN Library), starter kit, descri- 
zione delle classi e degli errori di codice, 
ora totalmente nella nostra lingua, rendo- 
no Visual Studio 2005 ancora più intuitivo 
e facile da usare. Oltre 400 le nuove funzio- 
nalità rispetto alle precedenti versioni 
.NET 2002 e 2003, che rendono Visual 
Studio 2005 decisamente più produttivo. 

PRODUTTIVITÀ 

Questa è la parola chiave su cui si fonda 
questa nuova versione dell'ambiente di 
sviluppo ideato da Microsoft per la pro- 
grammazione .NET. 

Se da un lato si registra un'alta integrazio- 
ne con la versione 2.0 del .NET Framework, 
dall'altro non possono passare inosservati 
wizard e accorgimenti di vario genere che 
caratterizzano il nuovo ambiente di svilup- 
po rispetto alle versioni precedenti. 

FRAMEWORK 2.0 

L'intero IDE si basa sul Framework 2.0 e ne 
sfrutta a fondo tutte le potenzialità. Non è 
più possibile sviluppare per il Framework 
1.1, né consigliabile. Il nuovo Framework 
porta con sé novità rilevanti quali i tipi 
generics, nuovi controlli, un maggior 
numero di classi, ed in generale una mag- 
giore efficacia. Visual Studio 2005 è alta- 
mente integrato con questa versione del 
Framework e ne diventa lo strumento 
naturale per lo sviluppo in tecnologia .NET. 

DATABASE 

Tutti sanno quanto lo sviluppo delle 
applicazioni sia spesso legato all'utiliz- 



zo di una base di dati. In questo senso le 
facilities messe a disposizione da Visual 
Studio 2005 sono veramente straordina- 
rie. Il cuore di tutto è un wizard per l'ag- 
giunta di una sorgente dati. Il wizard 
riesce a realizzare una stretta connessio- 
ne, sia con fonti di database tradizionali 
quali SQL Server 2005, Access o qualun- 
que altra fonte per cui esista un provi- 
der, sia con Web Services e persino con 
una classe sviluppata ad hoc dallo svi- 
luppatore per la gestione di connessioni 
proprietarie. Quel che più conta, è che 
da questo momento in poi la gestione 
del database diventa completamente 
trasparente per l'utente. È sufficiente 
trascinare un campo del db dal databa- 
se explorer sulla form per poterne gesti- 
re la visualizzazione ed eventualmente 
l'inserimento dati. Una semplice appli- 
cazione per la gestione di un database si 
realizza in meno di cinque minuti, spe- 
cialmente se la fonte è un db SQL Server 
2005 oppure Access. Da segnalare anche 
l'arrivo di una nuova DataGridView che 
sostituisce la vecchia DataGrid e porta 
con se una ventata di novità special- 
mente per quanto riguarda la persona- 
lizzazione. A margine di tutto questo è 
da segnalare che SQL Server 2005 gesti- 
sce adesso la base di dati con file esterni 
con estensione .mdf, con una logica 
molto simile a quella del vecchio mdb di 
Access, il che rende facilmente portabile 
da una macchina all'altra qualunque 
database. 



DATABASE 
DESIGNER 

In Visual Studio 2005 è presente uno 
strumento per la gestione delle relazioni, 
delle query e in generale per la 
progettazione delle basi di dati. Anche in 



questo caso si tratta di uno strumento 
particolarmente efficace e legato al 
concetto di integrazione. 



SMART TAG 

Altra novità molto interessante di Visual 
Studio 2005 sono gli Smart Tag, una sorta 
di menù contestuale dinamico e aggancia- 
to a controlli specifici, in grado di mostrare 
le funzionalità più comuni. Così, per esem- 
pio, tramite lo smart tag della 
DataGridView è possibile accedere diretta- 
mente ad un Wizard per la definizione 
delle colonne, oppure per il binding dei 
contenuti. 



FORM DESIGNER 

Sembra una novità di poco rilievo, eppure 
anche in questi particolari è importante 
notare come si sia posta grande attenzione 
alla produttività. I controlli possono essere 
adesso allineati fra di loro, in modo molto 
semplice, utilizzando delle linee guida 
calamitate. 



CLICKONCE 

Si tratta di un framework estremamente 
comodo, nato per risolvere i problemi 
della distribuzione del software, che 
permette all'utente d'installare in locale 
o usare da remoto le applicazioni per la 
piattaforma Windows 2000/2003/XP 
2006. Tramite ClickOnce, l'utente finale 
sarà in grado di utilizzare un'applicazio- 
ne Windows Forms (cioè un'applicazio- 
ne .NET per Windows) con un solo click 
del mouse. A seconda della tipologia di 
distribuzione che s'intende affrontare, 
sarà possibile scegliere una modalità 
d'installazione dal web, oppure standa- 
lone. In tutti i casi, grazie a ClickOnce, 



* 8 /Giugno 2006 



http://www.ioprogrammo.it 



Informazione pubblicitaria ■ T PUBBLIREDAZIONALE 



eventuali disponibilità di nuove versioni 
saranno comunicate all'utente e l'up- 
grade sarà estremamente facilitato. 

ASP .NET 2.0 

Moltissime novità sono state introdotte 
nei tool relativi allo sviluppo Web. 
Template e Pagine Master ne sono un 
esempio. È adesso possibile definire una 
pagina master, al cui interno possono 
essere contenute parti variabili e parti 
fisse. Ogni pagina ereditata da una pagina 
master potrà personalizzare le parti varia- 
bili, ma rimarrà omogenea alla pagina 
originaria per quanto riguarda le parti 
fisse. Allo stesso modo i template consen- 
tono di generare una grafica generale per 
il sito. Cambiando il template si cambierà 
l'intero layout del progetto senza dover 
ridisegnare tutte le pagine. Non di poco 
conto l'inserimento, all'interno dell'am- 
biente di sviluppo, di un Web Server per il 
testing delle pagine. Nella versione prece- 
dente era necessario installare sulla pro- 
pria macchina un server US per poter 
testare il software. Con Visual Studio 2005 
è sufficiente lanciare l'applicazione e con- 
testualmente verrà lanciato un server web 
compatibile con ASP .NET 2.0 su una 
porta random che eseguirà il codice svi- 
luppato. 

MOBILE EDITIOM 

Con Visual Studio 2005, eccetto che nelle 
versioni Express, è possibile anche svilup- 
pare applicazioni per dispositivi mobili. Il 
porting di un'applicazione standalone ad 
una progettata per un apparecchio mobile 
si riduce il più delle volte semplicemente a 
riprogettarne l'interfaccia utente. 

COMPATIBILITÀ 
COI\l LE VERSIONI 
PRECEDENTI 

Il porting da Visual Studio 2003 è assolu- 
tamente indolore. Un comodo Wizard 
eseguirà le operazioni necessarie per- 
ché tutto funzioni nel nuovo ambiente. 
Leggermente più complesso il porting 
da Visual Basic 6.0, ma Visual Studio 
2005 ha colmato tutte le carenze della 
precedente versione, divenendo uno 
strumento estremamente più potente e 
versatileln qualche occasione sarà 
necessario modificare manualmente il 



codice perché tutto funzioni corretta- 
mente. Tuttavia, c'è da dire che VB 6.0 
non è più ufficialmente supportato da 
Microsoft, per cui anche i più restii 
dovranno abituarsi all'idea di un upgra- 
de al nuovo prodotto. 

SOLUZIONI 
SU MISURA 

Visual Studio 2005 viene proposto in diver- 
se edizioni, tagliate su misura per le esi- 
genze dei singoli programmatori: 



VISUAL STUDIO 
2005 TEAM SYSTEM 

Strumenti produttivi, integrati ed estensi- 
bili per la gestione del ciclo di vita del 
software, pensati appositamente per otti- 
mizzare le comunicazioni e la collabora- 
zione tra i team durante l'intero processo 
di sviluppo. 

VISUAL STUDIO 2005 

PROFESSIONAL 

EDITION 

Si tratta di una versione pensata per il 
singolo sviluppatore, o per piccoli 
gruppi di sviluppo. Contiene tutti gli 
strumenti per realizzare applicazioni 
mission-critical, smart client, Web, 
mobili o basate su Microsoft Office. 
Permette di accedere in modo com- 
pleto all'ambiente di sviluppo 
Microsoft .NET Framework 2.0, e sup- 
porta la creazione di strumenti che 
estendono le funzionalità dell'am- 
biente IDE (Integrated Development 
Environment) di Visual Studio. Sono 
inoltre disponibili caratteristiche 
migliorate come "Edit and Continue", 
che consente di individuare e correg- 
gere rapidamente gli errori senza riav- 
viare le applicazioni. 

VISUAL STUDIO 2005 
STANDARD EDITION 

Strumenti di sviluppo volti alla creazione 
di applicazioni client/server e siti Web. Per 
gli sviluppatori che passano da Visual Basic 
6.0 a Microsoft .NET Framework 2.0, Visual 
Studio 2005 Standard Edition migliora la 
produttività, e offre la potenza necessaria 
per la creazione di applicazioni line-of- 
business. 



VISUAL STUDIO 2005 
EXPRESS EDITION 

Si tratta di prodotti estremamente intuitivi 
e di facile utilizzo, dedicati in particolare a 
utenti alle prime armi, completamente 
gratuiti e disponibili per il download e rela- 
tiva registrazione sul sito MSDN 
fhttp://www.microsoft.com/italy/msdn/default. 
mspxì . Si tratta di una licenza completa, 
liberamente utilizzabile anche in fase di 
produzione a tempo indeterminato, a cui 
mancano però strumenti avanzati di 
reportistica, funzionalità per sviluppo 
Mobile e altre caratteristiche disponibili 
nelle altre edizioni per professionisti. 
Visual Studio 2005 è disponibile sia come 
Licenza singola (Visual Studio 2005 nelle 
sue diverse edizioni), sia come Licenza + 
Software Assurance (Visual Studio 2005 
nelle sue diverse edizioni con MSDN 
Professional o con MSDN Premium). La 
Software Assurance di Visual Studio 2005 è 
MSDN, ossia la sottoscrizione periodica 
che garantisce il diritto a ricevere aggiorna- 
meni gratuiti alle ultime versioni, beta di 
prodotto in anteprima, software downloa- 
dabile gratuitamente, supporto tecnico 
gratuito e molti altri vantaggi. 

I prezzi di Visual Studio 2005 nelle sue 
diverse edizioni variano a seconda delle 
modalità di acquisto: 

• modalità Retail, ossia come prodotto 
pacchettizzato (la scatola del prodot- 
to), per chi necessita di una singola 
licenza; 

• modalità Volume Licensing (multili- 
cenza), acquistabile nell'ambito di uno 
dei seguenti programmi: Easy Open, 
Open Volume, Open Value, Select, 
Enterprise Agreement ed Enterprise 
Agreement Subscription. 

CONCLUSIONI 

Visual Studio 2005 rappresenta un elemen- 
to di rottura rispetto alle versioni prece- 
denti della piattaforma di sviluppo, grazie 
alla presenza di una serie di funzionalità 
che migliorano notevolmente la produtti- 
vità individuale. Inoltre, la disponibilità 
delle versioni Express Edition, rappresenta 
un'apertura anche verso il mondo del 
software OpenSource, che può in questo 
modo iniziare a sviluppare applicazioni 
.NET anche per l'ambiente Windows senza 
ricorrere a impegni monetari importanti. 
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GLI ALLEGATI DI IOPROGRAMMO 



t Eleganza e potenza 



Fino a qualche tempo fa il 
linguaggio di punta pro- 
mosso da Microsoft era 
Visual Basic, ed è ancora 
così... tuttavia da qualche 
tempo a questo monolite 
della programmazione si è 
affiancato C# che, per ele- 
ganza, disponibilità di 
costrutti, capacità di pro- 
grammazione a basso livello 
è diventato uno dei più 
amati dai programmatori 
professionali. Il linguaggio, 
da molti inizialmente critica- 
to perché troppo simile a 
Java, è diventato nel tempo 
un punto di riferimento sicu- 
ro ed un'irrinunciabile per 
chiunque si appresti a pro- 



grammare applicazioni in 
ambito Windows. In realtà 
come ben si può intuire, si 
presta molto bene anche alla 
costruzione di applicazioni 
web e per questo motivo 
assume quei connotati di 
flessibilità che lo rendono 
così amato dai programma- 
tori di tutto il mondo. I tre 
WebCast che ioProgrammo 
in collaborazione con MSDN 
vi presenta questo mese vi 
porteranno proprio a cono- 
scere le basi per iniziare a 
programmare in C#. Si tratta 
di un viaggio affascinante 
attraverso alcuni dei costrut- 
ti più eleganti disponibili in 
programmazione. 



I VIDEOCORSI PER PROGRAMMARE BENE 

3 WEBCAST 

«^UFFICIALI MICROSOFT 

HB GRATIS NEL CD "I CORSI DI FORMAZIONE" 
DA SEGUIRE COMODAMENTE SUL PC msdn 






VISUAL C# 2005 

• Introduzione a C# 

• C# Advanced Edition (prima parte) 

• C# Advanced Edition 
(seconda parte) 



INFORMAZIONI SU MSDN WEBCAST 

http://www.microsoft.it/msdn/webcast_msdn 
http://forum.ioprogrammo.it 




FAQ 



Cosa sono i Webcast MSDN? 

MSDN propone agli sviluppatori una serie di eventi gratui- 
ti online e interattivi che approfondiscono le principali 
tematiche relative allo sviluppo di applicazioni su tecnolo- 
gia Microsoft. Questa serie di "corsi" sono noti con il nome 
di Webcast MSDN 

Come è composto tipicamente 
un Webcast? 

Normalmente vengono illustrate una serie di Slide com- 
mentate da un relatore. A supporto di queste presentazio- 
ni vengono inserite delle Demo in presa diretta che 
mostrano dal vivo come usare gli strumenti oggetto del 
Webcast 

Come mai trovo riferimenti a chat 
o a strumenti che non ho disponibili 
nei WebCast allegati alla rivista? 

La natura dei WebCast è quella di essere seguiti OnLine in 
tempo reale. Durante queste presentazioni in diretta ven- 
gono utilizzati strumenti molto simili a quelli della forma- 
zione a distanza. In questa ottica è possibile porre doman- 
de in presa diretta al relatore oppure partecipare a son- 
daggi etc. I WebCast riprodotti nel CD di ioProgrammo, pur 
non perdendo nessun contenuto informativo, per la natura 



asincrona del supporto non possono godere dell'interazio- 
ne diretta con il relatore. 

Come mai trovo i WebCast 
su ioProgrammo 

Come sempre ioProgrammo cerca di fornire un servizio ai 
programmatori italiani. Abbiamo pensato che poter usu- 
fruire dei WebCast MSDN direttamente da CD rappresen- 
tasse un ottimo modo di formarsi comodamente a casa e 
nei tempi desiderati. Lo scopo tanto di ioProgrammo, 
quanto di Microsoft è infatti quello di supportare la comu- 
nità dei programmatori italiani con tutti gli strumenti pos- 
sibili. 

Su ioProgrammo troverò tutti 
WebCast di Microsoft? 

Ne troverai sicuramente una buona parte, tuttavia per loro 
natura i webcast di Microsoft vengono diffusi anche OnLine e 
possono essere seguiti previa iscrizione. L'indirizzo per saperne 
di più è: http://www.microsoft.it/msdn/webcast/msdn segnalo 
nei tuoi bookmark. Non puoi mancare. 

L'iniziativa sarà ripetuta sui prossimi 
numeri? 

Sicuramente si. 
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DISPONIBILE MOSAICO 
SORGENTE APERTO 8.0 

hag, la software house produttrice 
del noto gestionale Mosaico ne ha 
appena rilasciato la versione 8.0. 
Rispetto alle precedenti versioni sono da 
annotare la presenza del "sensore di al- 
larme sotto scorta", di una funzionalità 
"cruscotto" dedicata a chi vuole monito- 
rare il fatturato aziendale e SQLExec che 
consente di eseguire delle query dirette 
sul DB di Mosaico. Rimane invariata la di- 
sponibilità del codice sorgente. Da sem- 
pre Whag ha infatti adottato la politica 
di rendere disponibile il codice per gli 
sviluppatori affinché possano eventual- 
mente apportare le modifiche necessarie 
per le esigenze delle aziende, che come 
si sa sono talmente tante ed eterogenee 
che è quasi impossibile trovare un ge- 
stionale univoco per ogni tipologia di 
problema. La disponibilità del codice sor- 
gente è sinonimo di personalizzazione e 
flessibilità, decisamente un punto a fa- 
vore di Whag e di Mosaico. 

PHP APPRODA 
AL SUMMER 
OF CODE 2006 

on una delle sue grandi trovate Goo- 
gle, nel 2005, aveva inaugurato la 
stagione di Summer of Code. Sostan- 
zialmente una borsa di studio con cui 
software developer meritevoli guada- 
gnavano una esperienza all'interno di 
organizzazioni OpenSource nel campo 
dello sviluppo. Ciascuno studente rice- 
veva uno stipendio e la possibilità di con- 
tribuire al miglioramento di un proget- 
to OpenSource portando le sue idee e il 
suo lavoro all'interno dell'organizza- 
zione che ne curava lo sviluppo. L'idea 
ha avuto un enorme successo, tanto che 
l'operazione continua con la versione 
2006 del Summer of Code. Le organiz- 
zazioni partecipanti sono davvero mol- 
tissime e i nomi altisonanti, fra tutti ab- 
biamo scelto PHP che quest'anno apre 
agli sviluppatori ricercando, attraverso 
Summer of Code, profili in grado di mi- 
gliorare la nota piattaforma per lo svi- 
luppo di web application. Nella home 
page del progetto: http://code.goo- 
gle.com/summerofcode.html, campeg- 
giano comunque nomi altisonanti, da 
OpenSolaris ad Eclipse, da PostgreSQL 
a Samba. 



IN ARRIVO LA JAVA 
CONFERENCE 2006 



5i terrà a Roma il 26 Giugno 
2006, e a Milano il 27 e il 28 
Giugno l'undicesima Java Confe- 
rence. Come di consueto l'evento 
è rivolto a sviluppatori e a profes- 
sionisti dell'IT in generale, ma 
diversamente dagli anni prece- 
denti alle consuete giornate Mila- 
nesi se ne è aggiunta una Romana 
che testimonia la buona vitalità 
del mercato dello sviluppo anche 
nelle regioni del centro sud. 
Il tema di quest'anno sembra ri- 
percorrere uno dei grandi interro- 
gativi di tutti coloro che in un mo- 
do o nell'altro hanno investito nel 
settore dell'informatica: "Il futuro 



di Internet, il futuro del soft- 
ware". 

Al centro di ogni discussione l'e- 
voluzione del Web, che con la cre- 
scente disponibilità di banda e 
l'aumentare dei servizi disponibili 
influenza l'evoluzione di un nuo- 
vo modello di società, ben rap- 
presentata dal termine "Social 
Networking", ovvero un'insieme 
di persone che in nome di interes- 
si comuni formano un nucleo ben 
definito a cui Internet presta la 
propria infrastruttura. Non a caso 
Sun ha battezzato "Partecipation 
Age" un'epoca in cui attraverso la 
rete individui e operatori interagi- 



IL PENTAGONO ATTENDE 
GARY MCKINNON 



Ly hacker noto per avere forzato i si- 
i stemi informatici della Nasa è 
attualmente in attesa di conoscere 
il proprio destino. Se i giudici Ingle- 
si dovessero concederne l'estradi- 
zione in America, l'uomo rischie- 
rebbe fino a 70 anni di carcere! 
Il trentanovenne Londinese, Gary 
McKinnon, noto in rete con il nick- 
name di Solo era stato arrestato per 
la prima volta nel 2002 con l'accu- 
sa di avere violato circa 97 compu- 
ter appartenenti al dipartimento 
della difesa americano, alla marina 
e all'esercito. I danni subiti dai vari 
network sotto attacco ammonte- 
rebbero secondo una stima a 
900.000 dollari. L'uomo era stato 
immediatamente rilasciato nel 
2002 per poi essere arrestato una 
seconda volta nel 2005. Anche il se- 
condo arresto aveva dato esito ne- 
gativo, tuttavia il rilascio, questa 
volta, era stato subordinato al di- 
vieto per l'uomo ad accedere alla 
rete Internet. Se l'estradizione fos- 
se confermata, si prevede che gli 



Americani non sarebbero altret- 
tanto teneri, e che per McKinnon si 
aprirebbero le porte di Guantana- 
mano. Nel frattempo "Solo" si di- 
fende dicendo stava semplicemen- 
te cercando di capire se gli UFO 
esistono e afferma di essere sicuro 
che gli americani stanno lavorando 
su tecnologie "Antigravitazionali" 
che modificherebbero sostanzial- 
mente il modo di affrontare le mis- 
sioni nello spazio 
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scono continuamente per creare valo- 
re, opportunità e crescita. 
In questo contesto si pongono gli stru- 
menti di Sun che sono concepiti secon- 
do modelli di sviluppo innovativi tesi, 
da un lato a servire la crescente neces- 
sità di interazione attraverso la rete, 
dall'altro a garantire una maggiore si- 
curezza nelPutilizzo del networking e 
dei sistemi. Le parole d'ordine sem- 
brano essere dunque: "Software inte- 
so come servizio", "Open Source e ar- 
chitetture orientate ai servizi" e infine 
ma non ultimo in ordine di importan- 
za: "Ajax". Fra le presenze importanti, 
da segnalare quella di James Gosling, 
padre fondatore di Java e attualmente 
Vice Presidente di Sun Fellow Sun Mi- 
crosystems e quella si Glenn Edens re- 
sponsable di Sun Labs. 
Le informazioni sulla registrazione e 
gli aggiornamenti sul programma so- 
no disponibili su: 
www.sun.it/eventi /jc06 



E ANCORA GUERRA FRA 
GOOGLE E MICROSOFT 



Ly oggetto della contesa è questa vol- 
ita il nuovo Internet Explorer 7.0. An- 
cora non disponibile sul mercato, il 
nuovo prodotto è già portatore del se- 
me della discordia. Esattamente co- 
me nel caso di Firefox il nuovo browser 
integrerebbe una funzionalità di ri- 
cerca direttamente collegata a MSN 
Search di Microsoft che come si sa è un 
diretto concorrente di Google. Dato 
l'alto numero di installazioni del brow- 
ser, appare ovvio che questo tipo di 
strumento integrato si configurereb- 
be come una minaccia al libero mercato. 
E' interessante notare come la lotta si 
sia spostata dall'integrazione di Ex- 
plorer all'interno del sistema operati- 
vo all'integrazione di funzioni parti- 
colari all'interno del browser. Il con- 
cetto è sempre lo stesso. Chi detiene 
quote così enormi di mercato non do- 



vrebbe integrare nei propri strumen- 
ti di punta servizi ali in one tesi a con- 
dizionare in qualche modo gli utenti 
nella propria volontà all'acquisto o al- 
l'utilizzo di un servizio. Almeno questa 
è la tesi degli avversari di Microsoft. 
Assisteremo ad un'altra lotta come 
quella condotta per estrapolare il brow- 
ser dal sistema operativo? In quell'e- 
pica battaglia a farne le spese fu Net- 
scape, riuscirà il gigante Google a re- 
sistere all'avanzata del colosso di Red- 
mond? Questa volta tuttavia le parti 
sembrerebbero invertite, di fatto il lea- 
der nel campo dei motori di ricerca è 
Google, mentre Microsoft se pur uti- 
lizzando mezzi discutibili cerca di ri- 
tagliarsi una fetta di nella raccolta pub- 
blicitaria sul Web, attualmente ap- 
pannaggio quasi esclusivo proprio del 
rivale Google. 



ARRIVA MICROSOFT 

EXPERIMENTATION 

PLATFORM 

Volete sviluppare un nuovo servizio per 
Windows Live? potete farlo adesso effet- 
tuando le vostre sperimentazioni in un am- 
biente appositamente studiato per il testing. 
La piattaforma di sperimentazione è dispo- 
nibile all'indirizzo http://exp-platform.com 
/default, aspx e consente di lavorare in tutta 
tranquillità per estendere Windows Live: 
http:/ '/www .live.com. Windows Live è l'enne- 
simo test effettuato da Microsoft per garanti- 
re un'esperienza di navigazione e ricerca 
personalizzata per un utente. Il servizio, an- 
cora in beta, assomiglia, neanche a farlo ap- 
posta, proprio a Google, ma consente di per- 
sonalizzare la propria pagina aggiungendovi 
contenuti come Feed Rss o altri elementi di- 
namici. La creazione di questo "Labs" dedi- 
cato agli sviluppatori lascia intendere come 
nei prossimi anni, il terreno di scontro si 
sposterà sui servizi integrati, e come il con- 
cetto di sito web si sposterà per diventare 
"Servizio" web. L'acquisizione di nuovi uten- 
ti corrisponderà necessariamente anche a 
una maggiore capacità di attrarre investitori 
pubblicitari e tutto questo si potrà concretiz- 
zare solo offrendo servizi a valore aggiunto 
che svincolino l'utente da una piattaforma 
specifica. 



JAVA SARA OPENSOURCE? 



Rumors relativi a dichiarazio- 
ni di Johnatan Schwartz sul- 
la possibilità di rendere Java 
completamente OpenSource si 
sono diffusi nelle ultime setti- 
mane. La volontà di Schwartz 
di procedere in questa dire- 
zione sarebbe conferma di 
quanto Sun stia esploran- 
do ogni possibilità pur di 
tornare a produrre utili 
consistenti. 

Di fatto nonostante i" 
linguaggio sia ormai 
leader indiscusso all'in 
terno di dispositivi mobili 
e nonostante l'ottima dif- 
fusione anche in ambiti di 
programmazione tradizio- 
nale, tuttavia gli analisti 
rimangono scettici di fron- 
te al bilancio di Sun che 
nel terzo quarto del 2006 
avrebbe perso ben 217 
Moni di dollari. 
Shwartz rimane invece ot- 
timista. Gli investimenti 



fin qui effettuati saranno capi- 
talizzati negli anni avvenire e 
andranno di pari passo con 
il crescere dei servizi di re- 
te. In ogni caso rendere Ja- 
va Open Source sarebbe 
un passo importante, 
che da un lato in- 
crementerebbe an- 
cora di più la già 
enorme base di 
utenti, ma dall'al- 
tro potrebbe dar 
vita ad una serie di 
dialetti che non favo- 
rirebbero uno svilup- 
po omogeneo delle 
applicazioni, della 
documentazione e 
del segmento dei 
servizi. La tensione 
rimane alta, e molto 
di più ne sapremo 
proprio durante 
l'ormai imminente 
■ava Conference 
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Streaming video 



LA TELEVISIONE 
VA SU INTERNET 

BROADCASTING, UNICASTING, TV ON DEMAND, PAROLE CHE STANNO ENTRANDO NEL 
GERGO COMUNE. ECCO LE COSE CHE UN PROGRAMMATORE DEVE CONOSCERE PER 
FORNIRE RISPOSTE ADEGUATE Al PROPRI CLIENTI 
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In questo articolo: mostreremo sia le tecnolo- 
gie messe a disposizione da Microsoft per la 
trasmissione di audio e video su protocollo 
TCP/IP, sia come noi programmatori possiamo 
utilizzare queste conoscenze per creare applica- 
zioni in grado di proiettare contenuti multime- 
diali su Internet. Lo scenario è il seguente: 

1) Il nostro cliente vuole creare una televisione 
su Internet 

2) Desidera sia offrire contenuti in diretta televi- 
siva, sia offrire contenuti on demand 

3) Non vuole perdere tempo con la tecnologia. 
Ciò che ci chiede è poter premere due tasti e 
inviare i contenuti nel modo appropriato, 
senza doversi preoccupare di avere cono- 
scenze approfondite di informatica. D'altra 
parte il suo mestiere è quello di essere un for- 
nitore di contenuti, non un tecnico. 

Offriremo una soluzione basata su Windows 
2003, Windows Media Services, e Windows Media 
Encoder. Nella prima parte di questo articolo 
illustreremo una parte puramente sistemistica 
che ci farà capire qual è l'architettura di rete che 
sfrutteremo. Nella seconda parte creeremo l'ap- 
plicazione che il nostro cliente ci ha richiesto. 



WINDOWS MEDIA 
SERVICES 

WMS è un servizio installabile gratuitamente su 
Windows 2003. Coloro i quali dispongono di un 
sistema Windows 2003 possono installare WMS 
da Pannello dì Controllo/Aggiungi Rimuovi Ap- 
plicazioni/Aggiungi Rimuovi Componenti di 
Windows. Il naturale complemento di WMS è il 
Windows Media Player 10. 
Un utente che volesse visualizzare contenuti 
video provenienti da un server di streaming WMS 
dovrebbe utilizzare il protocollo MMS. Per un 



normale utente sarebbe sufficiente digitare in 
Windows Media Player 10: mms://indirizzodelser- 
ver/indirizzodipubblicazione/<opzionale indiriz- 
zo del video> per connettersi al server in questio- 
ne e poter visualizzare il file. Qual è il vantaggio 
di utilizzare un servizio di streaming rispetto a 
consentire ad un utente di scaricare completa- 
mente un file per visualizzarlo in un secondo 
momento? Prima di tutto un server di streaming 
consente la diretta, o come si dice in gergo il 
"Live Streaming". Nel caso in cui invece si voles- 
sero mettere a disposizione contenuti registrati 
in precedenza, l'utente sarebbe sempre costretto 
a visualizzarli sul nostro sito, con evidenti van- 
taggi in termini di "brand". 
In sostanza, siamo sicuri che un video o un file 
MP3 non possa essere copiato, viceversa possa 
essere semplicemente riprodotto con le modalità 
che noi riteniamo più opportune. 
Potremmo anche decidere di proteggere i con- 
tenuti con una password e fornire l'accesso solo 
agli utenti registrati al servizio. Infine, un server 
di streaming consente di gestire la pubblicità, il 
palinsesto, e la banda. Ovvero, di uno stesso file 
potrebbe fornire una trasmissione a bande diver- 
se a seconda della disponibilità dell'utente che 
sta accedendo al servizio. 



WINDOWS 
MEDIA ENCODER 

WME è lo strumento di Microsoft che consente 
di effettuare una codifica audio o video dei dati 
che si intendono trasmettere. Normalmente per 
codifica si intende: "compressione". Attualmen- 
te siamo giunti alla versione numero 9, e il pro- 
dotto è liberamente scaricabile dall'indirizzo 
http://www.microsoft. com/windows/windowsme- 
dia/forpros/ encoder/ default. mspx. L'importanza 
di WME all'interno della nostra architettura è 
fondamentale. Di fatto WME consente di cattura- 
re audio e video da una fonte esterna, com- 
primere i dati in tempo reale e inviarli a un Win- 
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dows Media Services che si occuperà di renderli 
disponibili a tutti i client che ne vorranno fare 
uso. Per cui, supponendo che al vostro computer 
sia collegata una telecamera, Windows Media 
Encoder, catturerà il segnale dalla telecamera e 
lo sparerà verso il Windows Media Services. A 
questo punto un qualunque utente dotato di 
Windows Media Player potrà connettersi al servi- 
zio e visualizzare in tempo reale i dati trasmessi 
dalla telecamera. In un mondo ideale tutto que- 
sto sarebbe già sufficiente a risolvere il nostro 
problema. Dovremmo installare Windows Media 
Encoder sul computer del cliente, insegnarli ad 
usarlo, e tutto sarebbe risolto. In realtà però il 
WME è un software complesso, che consente 
diverse modalità di codifica, specializzato in 
alcune applicazioni, ma mancante completa- 
mente di altre. Nessun cliente al mondo vorreb- 
be usare direttamente il WME, piuttosto deside- 
rerebbe un'applicazione semplice che gli con- 
senta di astrarsi totalmente dalla conoscenza sia 
del software sia dell'architettura sottostante. Per 
tale motivo è nato il Windows Media Encoder 
SDK che installa, in una macchina in produzio- 
ne, tutto l'occorrente per richiamare API messe a 
disposizione dal WME. Sarà proprio questo com- 
ponente COM che utilizzeremo all'interno della 
nostra applicazione .NET per garantire alcune 
funzioni ed eliminare completamente le altre. 
Nel frattempo però sarà utile conoscere alcune 
caratteristiche del Windows Media Encoder che 
ci serviranno per meglio comprendere in un 
secondo momento quanto andremo a fare. 



LA PRIMA 
COMPRESSIONE 

Inizieremo con il comprimere un file avi già 
presente sull'hard disk. Non prenderemo per 
ora dati da una sorgente esterna. Tutto quello 
che vogliamo fare è familiarizzare con le tec- 
niche di compressione. 

1 Avviamo il Windows Media Encoder e sele- 
zioniamo dalla relativa dialog box il pro- 
getto "convert a file" 



Wiiards Quick Starts 



.. 


bè 


4 B 


Custom 


Broadcast a 


MS 


session 


live event 


or video 


oà 






Capture 







Selezioniamo il file di input e indichiamo 
un percorso per il file di output 
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Stabiliamo che il formato della distribu- 
zione debba essere un Windows Media 
Server, ovvero un server di streaming 
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I TUOI APPUNTI 



Stabiliamo la qualità della compressione. 

Questo passaggio è molto importante. 
Scegliendo infatti Multiple Bit Audio e Mu- 
ltiple Bit Video, si produrrà un formato com- 
presso in grado di negoziare la qualità della 
trasmissione a seconda della banda disponi- 
bile, in modo del tutto automatico e senza 
l'intervento esterno dell'utente. In questo 
modo chi utilizza un modem per la visualizza- 
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zione dello stream riceverà un filmato in una 
qualità tale da essere gestibile dalla propria 
connessione, chi utilizzerà l'ADSL beneficierà 
di una qualità senza dubbio più elevata. Da 
questa finestra dipende molto della qualità 
del servizio che offriremo ai nostri clienti. 

5 Inseriamo informazioni aggiuntive che 
verranno visualizzate nel player durante la 
riproduzione del video 



Display Information 
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Le operazioni di codifica sono terminate. 

Ora possiamo dare il via alla conversione. 
Se tutto è andato a buon fine visualizzeremo 
nel player il risultato del nostro video. 



LA PRIMA 

TRASMISSIONE 

INTERNET 

Per questo nostro primo "tentativo" eviteremo di 
trasmettere in diretta, piuttosto, renderemo dispo- 
nibile una trasmissione preregistrata in modalità 
"On Demand". La TV On Demand è uno dei feno- 
meni su cui si dibatte negli ultimi anni, e qualcuno 
fra digitale terrestre e TV satellitare non tiene nella 
dovuta considerazione la TV Over IP. Tv Over IP 
significa visualizzare sul proprio televisore di casa 
una trasmissione televisiva, scegliendola quando e 
come lo si vuole da una televisione basata su 
Internet come quella che stiamo sviluppando noi. 
Certo siamo ancora lontani da questo obiettivo, la 
banda non è sufficiente e le TV moderne non sono 
ancora in grado di scaricare con una qualità accetta- 
bile i flussi Internet. Tuttavia si intravede già quale 
potrebbe essere la direzione del futuro. 
Intanto facciamo qualche distinzione fra: singolo fil- 
mato, trasmissione televisiva, emittente televisiva. 
Per singolo filmato si intende quello che comu- 
nemente viene indicato come "Servizio", per tra- 
smissione televisiva si intende un insieme di servizi, 
per emittente televisiva si intende un soggetto che 



propone una serie di trasmissioni televisive spesso 
organizzate in palinsesti. 

Ad esempio il classico servizio di un telegiornale è 
un filmato singolo, un telegiornale è una trasmissio- 
ne televisiva, la Rai è un'emittente TV II nostro 
scopo sarà proprio riproporre una struttura simile, 
con la differenza che l'emittente TV se vuole può 
evitare di creare un palinsesto ad orario, in quanto la 
nostra TV è On Demand. Per questo motivo, il nostro 
server equipaggiato con Windows Media Services 
sarà equiparato a un'emittente TV e corrisponderà 
al nome del computer o all'indirizzo Internet su cui 
risiede il servizio. Nel nostro caso utilizzeremo il 
classico localhost visto e considerato che stiamo 
facendo degli esperimenti in locale. Indicheremo 
una "trasmissione televisiva" come "Publishing 
Points". Ciascun Publishing Points sarà composto da 
uno o più filmati. I Publishing Points potranno tra- 
smettere in modalità Broadcasting o Unicasting. Per 
modalità Broadcasting si intende che il video verrà 
trasmesso sequenzialmente e tutti i client che si 
connetteranno per guardarlo lo visualizzeranno in 
maniera sincrona. Ovvero ciascun client vedrà scor- 
rere le stesse immagini nello stesso tempo. Questa 
modalità è utilizzata soprattutto nelle trasmissione 
Live in presa diretta, per ovvi motivi. La modalità 
Unicast invece consente a ciascun client di avviare la 
ripresa del video in modalità asincrona, scegliendo 
quando e come avviare il video indipendentemente 
dagli altri. Questa modalità è indicata per la TV On 
Demand che è quella che utilizzeremo in questo 
esempio. Infine ciascun "Publishing Points" può 
avere delle caratteristiche. Ad esempio una sigla ini- 
ziale e una sigla finale, che devono essere sempre 
visualizzate qualunque sia il servizio che viene ri- 
chiesto dall'utente. Oppure pubblicità agganciata 
ad un particolare servizio sotto la forma di 
"Banner". Di tutte queste operazioni si occupa il 
Windows Media Server. 

Perciò dal menu start/ali programs/admi- 
nistrative tools avviate "Windows Media 

Services". Vi comparirà qualcosa di molto 

simile all'immagine seguente: 
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2 Cliccate su "Publishing Points" e con il 
tasto destro del mouse su "Add Publishing 
Points" 
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3 date un nome significativo al vostro Publi- 
shing Points, ad esempio TG200406, che 
indica telegiornale del 20 Aprile 2006. 
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4 selezionate il tipo di trasmissione che 
volete effettuare, nel nostro caso "Files in a 
directory...." 




selezionate On Demand Publishing Point e 

la directory dove conserverete i singoli 

servizi componenti la trasmissione televisiva. 

Curatevi anche di selezionare il checkbox: 

"Enable Access to directory content.... " 




6 abilitate il logging se lo volete e proseguite 
fino alla fine, nella schermata successiva 
indichiamo di voler creare un: 

• wrapper playlist (wsx) 

• announcement files (asx) 

• pagina web (htm) 

vedremo in seguito a cosa ci serve tutta que- 
sta roba. Nel frattempo occupiamoci di dire al 
wizard di creare i file che ci servono e di collo- 
carli in posizioni che gli indicheremo. Possia- 
mo lasciare le impostazioni di default per tut- 
te le schermate che ci verranno proposte. 
Il wizard si occuperà di creare per noi i file ri- 
chiesti. Copiamo all'interno della directory 
che abbiamo indicato per il publishing points 
un qualunque file WMV contenente un filma- 
to, e testiamo se tutto funziona collegandoci 
con il Windows media player all'uri: mmsilllo- 
calhost/TG200406. 



LA PLAYLIST 

Nel tutorial precedente abbiamo lasciato che 
il wizard creasse il file Wrapper Playlist con 
estensione wsx. Questo file contiene una lista 
dei servizi che comporranno il nostro publi- 
shing points. Se apriamo il file in questione 
scopriremo che contiene qualcosa del genere: 

<?wsx version = "1.0"?> 
<smil> 

< media src="%requestedUrl%"/> 
</smil> 
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Come potete vedere, si tratta di un file XML 
composto con un set ridotto del linguaggio 
SMIL. Questa prima versione del file wsx che 
vi presentiamo è molto semplice da interpre- 
tare. Dice semplicemente che ogni volta che 
un utente richiede un servizio appartenente a 
quel publishing point, deve essere inviato al 
client proprio il servizio richiesto. 
Supponiamo ad esempio che il publishing 
points contenga il servizio "Kenwood. wmw". 
Richiamando mms://localhost/TG200406/ken- 
wood.wmv verrebbe visualizzato proprio il 
servizio in questione. Ma non sempre è que- 
sto il comportamento che ci attendiamo. Ad 
esempio vorremmo che qualunque fosse il 
servizio richiamato all'interno di un publi- 
shing points, venga sempre visualizzato pri- 
ma di esso un filmato di sigla e uno di coda. 
Vediamo come cambiare il file in questione 
per realizzare quanto detto: 

<?wsx version="1.0"?> 
<smil> 

<media role="advertisement" noSkip="TRUE" 

src="C:\WMPub\WMRoot\TtimeTV.wmv"/> 

< media src="%requestedllrl%"/> 

<media role="advertisement" noSkip="TRUE" 

src="C:\WMPub\WMRoot\TtimeTV.wmv"/> 

</smil> 

Se provate adesso a connettervi all'indirizzo 
mms://localhost/TG200406/kenwood.wmv o a 
qualunque servizio appartenente al publi- 
shing point TG200406 scoprirete che verrà 
sempre visualizzata una sigla, poi il servizio 
richiesto, poi la una sigla di coda. Potete ov- 
viamente aggiungere quanti servizi volete alla 
directory e automaticamente saranno inclusi 
nel publishing points e visualizzati nel brow- 
ser in ordine alfabetico. Se volete potete cam- 
biarne l'ordine proprio attraverso la playlist. 
Quello che è importante sottolineare in que- 
sta modifica fatta al file wsx è relativa all'in- 
troduzione della parola chiave advertisement 
seguita dall'argomento noSkip che realizza 
appunto l'effetto desiderato. 
Volendo possiamo complicarci ancora la vita, 
ad esempio modificando la playlist nel se- 
guente modo: 

<?wsx version="1.0"?> 
<smil> 

<media role="advertisement" noSkip="TRUE" 

src="C:\WMPub\WMRoot\TtimeTV.wmv"/> 

< media src="%requestedllrl%"> 

<clientData title="Play" bannerAbstract= 

"Playgeneration" bannerInfoURL= 
"http://www.edmaster.it/?job=prodotti& 



id = 64" bannerURL= 
"http://www.edmaster.it/banner/468x60_play.gif7> 
</media> 
<media role="advertisement" noSkip="TRUE" 

src-"C:\WMPub\WMRoot\TtimeTV.wmv"/> 

</smil> 

Così facendo abbiamo comunicato al server 
di streaming che desideriamo che un banner 
pubblicitario sia proiettato in uno spazio 
appositamente riservato all'interno del pla- 
yer. Notate che abbiamo realizzato questo in- 
serendo un nodo clientData all'interno di me- 
dia. In realtà in una playlist composta da più 
media è possibile inserire il clientData come 
leaf di ciascun media, di modo che ogni filma- 
to possa essere associato ad una campagna 
banner specifica. Infine è da segnalare la pos- 
sibilità di creare una playlist dinamica. Dove 
ad esempio le sigle iniziali e finali variano sul- 
la base di un AD Server che sponsorizza la tra- 
smissione. Supponiamo ad esempio di avere 
10 Sponsor per la trasmissione X e che ciascu- 
no sponsor abbia richiesto che il proprio spot 
pubblicitario sia visualizzato Y volte. È ovvio 
che non possiamo mettere tutti gli sponsor 
nel file smil sotto la forma di advertising, per- 
ché ogni volta dovremmo mostrare 10 filmati 
prima di ottenere il servizio richiesto, inoltre è 
molto probabile che lo sponsor voglia ottene- 
re un report delle visualizzazioni etc. Perciò 
sarebbe opportuno avere un server AD sepa- 
rato che scegliesse quale filmato mostrare 
prima del servizio richiesto. Proviamo a modi- 
ficare il file smil come segue: 

<?wsx version="1.0"?> 
<smil> 

<media role="advertisement" noSkip="TRUE" 

src="httpd://localhost/DynamicPlaylist.aspx"/> 
< media src="%requestedllrl%"> 

<clientData title="Play" bannerAbstract= 

"Playgeneration" bannerlnfolIRL- 

"http://www.edmaster.it/?job=prodotti& 

id = 64" bannerURL- 

"http://www.edmaster.it/banner/468x60_play.gif7> 



</media> 



<media role="advertisement" noSkip="TRUE" 

src-"C:\WMPub\WMRoot\TtimeTV.wmv"/> 

</smil> 

Abbiamo cambiato il src del primo advertising 
fornendogli un indirizzo httpd dinamico. 
Questo fa sì che il contenuto del file da visua- 
lizzare venga adesso prelevato dal file Dyma- 
nicPlaylist.aspx. Questo file è un file asp.net 
che può contenere una qualsiasi logica per il 
reperimento del file wmv da visualizzare, pur- 
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che al suo interno alla fine sia contenuta qual- 
che istruzione del genere 

Response.Write("<?wsx version=\"1.0\"?>\r\n"); 

Response.Write("<smil>\r\n"); 

Response.Write(" <media src=\"" + ads[index] + "\" 
noSkip=\"true\"" + "role=\"Advertisement\" 
/>\r\n"); 

Response.Write("</smil>\r\n"); 

che appunto indica al server quale file di ad- 
vertisment deve essere visualizzato 



INSERIRE IL PLAYER 
IN UNA PAGINA HTML 

Anche in questo caso ci viene in aiuto il brow- 
ser. Se date uno sguardo a quanto prodotto 
dal wizard vi accorgete che avete un file .html 
contenente uno scheletro che potete riutiliz- 
zare all'interno tipicamente di inetpub/www- 
root. Vi riproponiamo semplicemente qual- 
che spezzone del codice tanto per farvi rende- 
re conto di come questa tecnica viene ap- 
plicata: 

<script language="Javascript"> 
if( g_bNetscape ) 
{ 

document.writeln( 
"<APPLET mayscript code=WMPNS.WMP 
name=WMPl width = 300 
height=2QQ MAYSCRIPT >" ); 

} 
</script> 

«DBJECT CLASSID="clsid:6BF52A52- 

394A-11D3-B153-00C04F79FAA6" 

ID="WMP"> 

<PARAM NAME="Name" VALUE="WMP1"> 

<PARAM NAME="URL" VALUE = 

"mms://JACO20Q3SERVER/TG2QQ4Q6"> 

</OBJECT> 

</APPLET> 

</td> 



LIVE STREAMING 
COm WINDOWS MEDIA 
ENCODER 

Siamo finalmente giunti al momento in cui 
possiamo effettuare la prima trasmissione vi- 
deo in diretta televisiva. Lo scenario è quello 
di uno studio televisivo presente ad esempio a 



Roma che trasmette il video a un server in 
housing a Milano, al quale a loro volta i client 
Windows Media Player si connettono per po- 
ter visualizzare la trasmissione. Iniziamo lan- 
ciando il Windows Media Encoder e selezio- 
nando una custom session. 



Portiamoci nella scheda di configurazione 
e in sources settiamo: 



Name = test 

Source from device (o from file a seconda di 

qual è il vostro dispositivo di ingresso) 




Output Compression Video Size Attributes Processing Plug-ins Security Advanced 



Select the sources to encode in this sì 
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I Apply 



nella tabsheet output selezioniamo push to 

server, in server name inseriamo il nome 

del server più una porta libera, infine il nome 

del publishing point y spuntiamo anche il 

check autoremove 
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3 spostiamoci nella tabsheet compression, 
scegliamo CBR per ottenere i vari formati 
di compressione e spuntiamo quelli che ci in- 
teressano 
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4 clicchamo su apply e diamo il via alla tra- 
smissione. Se tutto è andato a buon fine 
un nuovo publishing point verrà creato auto- 
maticamente sul server e la trasmissione sarà 
visibile in broadcast. In sostanza è l'encoder 
che si connette al server e crea il publishing 
point, di modo che nessun intervento debba 
essere richiesto al sistemista. 

Ovviamente il nostro scopo adesso è replica- 
re la stessa situazione fornendo al nostro 
cliente non l'intero encoder ma un'interfac- 
cia semplificata che gli consenta di gestire 
facilmente l'invio di uno stream al server. 



IL WINDOWS MEDIA 
ENCODER SDK 

Sul sito di Msdn all'indirizzo http://www.mi 
crosoft. com/downloads/details. aspx?familyid 
=000al6f5-d62b-4303-bb22-f0c0861be25b&- 




E NON HO WINDOWS SERVER 2003? 



La trasmissione di video su 
Internet sta diventando 
abbastanza comune da avere 
favorito la proliferazione di 
provider di Hosting che mettono a 
disposizione Windows Server 2003 
per i propri clienti. In sostanza 
mentre il Windows Media Encoder 
continuerà a risiedere sulla vostra 
macchina, potrete connettervi in 
remoto a un Windows Media 
Services per effettuare la 
trasmissione in Broadcasting o in 
Unicasting. 

In tal caso una normale 
connessione ADSL è tipicamente 



sufficiente per trasmettere il video 
in modo fluido. Tuttavia è 
importante che la disponibilità di 
banda del vostro provider di 
Hosting sia sufficiente a coprire in 
modo ottimale la ritrasmissione 
dei dati per molti clienti in 
contemporanea. Quando vi 
affidate a un hoster tipicamente 
usufruite di un servizio "Shared" 
quindi non siete solo voi a 
trasmettere. Se non volete che la 
connessione proceda a scatti 
dovete assicurarvi con il vostro 
provider che sia in grado di 
sostenere questo compito. 



displaylang-en è disponibile il Windows Me- 
dia Encoder sdk. Una volta installato ci mette 
a disposizione alcuni esempi interessanti per 
interagire con gli strumenti dell' encoder. 
Ad esempio viene distribuita un'applicazione 
di scheduling che consente di schedulare 
l'encoding di file contenuti in una directory 
ad intervalli di tempo ben definiti. Oppure 
un'applicazione web per il remote control di 
un sistema di encoding. Ciò che è più impor- 
tante ci mette a disposizione diversi oggetti 
COM da poter utilizzare nelle nostre applica- 
zioni. Creare un'applicazione che invìi un 
flusso in streaming a un Windows Media Ser- 
ver è abbastanza semplice. 
Prima di tutto bisogna referenziare all'inter- 
no di un progetto .NET l'oggetto COM Win- 
dows Media Encoder, nell'ordine è necessa- 
rio poi eseguire i seguenti passi: 

1) Creare un oggetto encoder 

2) Creare un gruppo che identifichi lo 
stream che si vuole mandare in trasmis- 
sione 

3) Specificare il metodo di streaming 

4) Avviare l'encoding 

Un esempio di applicazione Visual Basic.NET 
che fa tutto questo è la seguente: 

Imports WMEncoderLib 
Public Class Formi 



Dim Encoder As WMEncoder 



Dim SrcGrpColl As IWMEncSourceGroupCollection 

Dim SrcGrp As IWMEncSourceGroup 

Dim SrcAud As IWMEncSource 

Dim SrcVid As IWMEncVideoSource 

Dim ProColl As IWMEncProfileCollection 

Dim Pro As IWMEncProfile 

Dim PushDist As IWMEncPushDistribution 

Dim strServerName As String 

Dim strPubPoint As String 

Dim strPubTemplate As String 

Dim MyNSCFile As String 

Dim MyNSCURL As String 

Dim MyASXFile As String 



Private Sub Forml_Load(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles MyBase.Load 



J 



'Crea l'oggetto WMencoder 


Encoder = New WMEncoder 


End Sub 


Private Sub Buttonl_Click(ByVal sender As 
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System. Object, ByVal e As System. EventArgs) 
Handles Buttonl. Click 
If OpenFileDialogl.ShowDialogO = 

Windows. Forms.DialogResult.OK Then 
ListBoxl.Items.Add( 

OpenFileDialogl.FileName) 
End If 

End Sub 

Private Sub Button2_Click(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles Button2. Click 
SrcGrpColl = Encoder.SourceGroupCollection 

' Crea un gruppo chiamato SG_1. 

SrcGrp = SrcGrpColl.Add("SG_l") 

' Specifica la sorgente 
'Qui lasciasmo commentata la linea che recupera 

anche una sorgente audio 

'SrcAud = SrcGrp. AddSource( 
WMENC_SOURCE_TYPEWMENC_AUDIO) 

SrcVid = SrcGrp. AddSource( 
WMENC_SOURCE_TYPE.WMENC_VIDEO) 

' Specifica il path del file sorgente 

' nel nostro caso lo recuperiamo dal 

contenuto di una listbox 
'SrcAud. Setlnput("c: \audio.wav") 
SrcVid. SetInput(ListBoxl.Items(0).ToString()) 



'Se vogliamo prendere come sorgente un device 
'SrcAud. SetInput("device://default_audio_device") 
'SrcVid. SetInput("device://default_video_device") 



End Sub 



End Class 

Come vedete, replichiamo in modo program- 
matico gli stessi indentici passaggi che abbia- 
mo fatto con l'encoder. Il nostro scheletro di 
applicazione è pronto! Potete modificarlo co- 
me meglio credete per offrire ai vostri clienti il 
miglior servizio possibile. 



CONCLUSIONI 

Il video over IP è probabilmente il mezzo più 
trascurato rispetto al digitale terrestre e al sa- 
tellitare. Probabilmente perché ancora manca 
quell'immediatezza d'uso che invece la televi- 
sione tradizionale ha. Tuttavia al crescere 
della disponibilità della banda e al migliorare 
dell'integrazione della tv tradizionale con il 
protocollo IP siamo certi che questo mezzo di 
trasmissione sarà un grande competitor per 
tutti gli altri. Naturalmente al momento esi- 
stono ancora alcune limitazioni che non con- 
sentono un uso fruibile del mezzo da parte 
delle famiglie, come invece accade per la TV 
tradizionale, prima fra tutte la disponibilità 
della banda. Tuttavia al crescere dell'infra- 
struttura di rete sarà inevitabile considerare 
questo tipo di trasmissione dati come una fra 
le candidate ad essere il mezzo televisivo del 
futuro. Noi programmator dovremo farci tro- 
vare pronti a supportare i clienti che vorranno 
tuffarsi in questo campo. 




' Stabilice il profilo da utilizzare per la codifica. 
ProColl = Encoder.ProfileCollection 
Pro = ProColl. Item(2) 
SrcGrp. Profile = Pro 



' Definisce l'encoding in broadcast. 
PushDist = Encoder. Broadcast 



' Definisce il nome del publishing Point e la porta 
strServerName = "localhost:8888" 
strPubPoint = "publicationpoint" 



' Rimuove il publishing point quando la 
1 Trasmissione è finita 

PushDist. AutoRemovePublishingPoint = True 



PushDist. ServerName = strServerName 

PushDist. PublishingPoint = strPubPoint 

Encoder. PrepareToEncode(True) 

' Start encoding. 

Encoder.Start() 

MsgBox("Click OK to stop broadcasting.") 




SO DEI PROTOCOLLI 



Può capitare in qualche caso 
che la stazione trasmittente o 
ricevente sia costretta a 
lavorare all'interno di un 
network protetto da firewall. 
Ci vengono in aiuto i vari 
protocolli supportati da 
Windows Media Services. In 
particolare WMS usa due 
protocolli per trasmettere in 
unicast i dati ai client. 

RTSP: acronimo di Real Time 

Streaming Protocol 

MMS: acronimo di Microsoft 

Media Server Protocol 

RTSP è un protocollo studiato 

appositamente per consentire 

la trasmissione dei dati in Real 

Time, MMS viceversa è un 

protocollo proprietario 



studiato che agevola le 
connessioni con client di tipo 
Windows Media Player. 
Infine è possibile effettuare lo 
streaming anche su protocollo 
http tipicamente usato dai 
servizi web e disponibile 
solitamente anche quando il 
proprio network è coperto da 
firewall. 

Il vantaggio di poter usufruire 
di protocolli come RTSP o MMS 
sta soprattutto nel fatto di 
poter utilizzare quella che 
viene detta la classica funzione 
di "Rollover" , che consente 
un'ottimizzazione della 
trasmissione tra client e server 
e in casi di fault è in grado di 
rinegoziare in modo ottimale 
la ritrasmissione dei contenuti 
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PHP ALLA RICERCA 
DELLE PRESTAZIONI! 

IN QUESTO ARTICOLO, IMPAREREMO ALCUNE COSE SUI MECCANISMI INTERNI 

DI FUNZIONAMENTO DI PHP E UTILIZZEREMO UN'ESTENSIONE CHE RADDOPPIA LA VELOCITÀ 

DI ESECUZIONE DEGLI SCRIPT! PRONTI, PARTENZA... VIA 




jn 




REQUISITI 



■ imi i ^ 

9 Basidi 
1 programmazione PHP 




Uno dei vantaggi più grandi di PHP sta nel- 
l'essere un linguaggio di scripting. Cosa 
vuol dire? Molto semplicemente che potete 
scrivere le vostre applicazioni in un notepad salvan- 
dole in un classico file di testo, potete piazzare i 
vostri script su un server, e magicamente tutto fun- 
zionerà senza dover compilare, aggiungere DLL o 
altro. Ma, esattamente, come funziona questo mec- 
canismo di scripting? Se ci pensate la soluzione è 
abbastanza semplice. Sul nostro web server abbia- 
mo un file di testo, ad esempio index.php, che po- 
trebbe contenere qualcosa del genere: 



<? 



phpinfoQ; 



quando un utente punta il browser all'indirizzo che 
espone questo file, ad esempio httpj/localhost 
/-apc/index.php, il server riconosce che è stato ri- 
chiamato un file con estensione PHP e richiama lo 
"zend engine". 

L'engine effettua un parsing del file in questione, lo 
compila e genera un opcode, ovvero il corrispon- 
dente in linguaggio macchina di quanto espresso 
dallo script con il linguaggio ad alto livello. A questo 
punto, chiaramente, la macchina sarà in grado di 
eseguire il codice. Quando lo script termina l' opco- 
de viene distrutto! Cosa vuol dire tutto questo? 
molto semplicemente che ogni volta che uno script 
viene richiamato deve riavviarsi il processo di com- 
pilazione, questo ovviamente consuma numerosi 
cicli macchina con conseguente perdita di tempo. E 
se in uno script ci fossero file inclusi, cosa succede- 
rebbe? Considerate ad esempio il seguente spezzo- 
ne di codice: 



<? 



require_once('db.php'); 



require_once('extension.php'); 



print "test eseguito"; 



1) verrebbe compilato lo script principale e man- 
dato in esecuzione; 

2) durante l'esecuzione si incontra la prima diret- 
tiva di inclusione, quindi anche il secondo file 
viene compilato ed eseguito con la stessa logica; 

3) si incontra poi la seconda direttiva di inclusio- 
ne, anche in questo caso è necessario ricompi- 
lare; 

4) infine lo script viene eseguito e completato cor- 
rettamente. 

Tutto questo ogni volta che lo script viene richia- 
mato. Immaginate per centinaia di accessi concor- 
renti quanti cicli macchina devono essere impiega- 
ti per soddisfare queste esigenze. 



ì compite ; 
main script 



load coi 



execute 
main script 



compile 
; included script ; 

- f - 

execute 
included script 



complete 



load 
compite* 
script frc 
cache 



in questo caso: 



Fig. 1: Diagramma di flusso dell'esecuzione classica 
di uno script PHP 



LA SOLUZIONE APC 

APC ovvero Alternative PHP Cache è un'estensione 
di PHP che consente di "salvare" uno script compi- 
lato in un'area di memoria e di richiamarlo ogni 
volta che ce ne fosse bisogno senza doverlo ricom- 
pilare. Con APC il diagramma di flusso dell'esempio 
precedente diventerebbe 

1) viene "caricato" il file index.php; 

2) si controlla se questo file compilato è già pre- 
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sente nella cache; 

3) se il file non è stato compilato, lo si compila e lo 
si mette nella cache; 

4) se il file è stato compilato si controlla se è stato 
modificato dopo l'ultima compilazione; 

5) se è stato modificato lo si ricompila e lo si salva 
di nuovo nella cache; 

6) se non è stato modificato lo si carica dalla cache 
e lo si esegue. 

questa procedura viene eseguita ricorsivamente per 
ogni file incluso nello script, con evidenti guadagni 
in termini di tempo 



phpinfoQ; 



?> 



conr 


pile 

script 






~7* 


11 


compila 
includcd script ! 


execute 


ma in script 


* 




i 

• 


execute 
include*] script 

1 


1 




complete 





load compi (ed script 



is script 
cached? 



ha s seri pt 



se* 



V 



Fig. 2: II diagramma di funzionamento dell'esecuzione 
di uno script con l'estensione APC installata 



DALLA TEORIA 
ALLA PRATICA 

APC è un'estensione di PHP Si mormora che sarà 
inserita di default nel nascituro PHP 6, fino ad oggi 
siamo ancora costretti ad installarla dalla PECL. Per 
gli utenti Linux questo si riduce ad eseguire dalla 
bash il seguente comando: 

peci instali ape 

per gli utenti Windows sarà necessario invece scari- 
care la apc.dll dal repository http://itphp.net/get 
/pecl-5.1.2-Win32.zip/from/a/mirror } in tutti e due i 
casi sarà necessario aggiungere l'estensione nel 
php.ini, come segue: 

[per gli utenti Windows] 
extension=apc.dll 



[per gli utenti linux] 



extension=apc.so 

e naturalmente riawiare Apache o US se si sta usan- 
do il Web Server di Microsoft. Nessun' altra configu- 
razione è necessaria per attivare APC. 
Per essere sicuri che tutto funzioni, creiamo un file 
index.php con all'interno le seguenti istruzioni: 



puntiamo il browser all'indirizzo che espone il file 
in questione e se tutto è andato a buon fine, trove- 
remo APC tra le estensioni attive, come mostrato in 
Figura 3. 



&f< '.upp'.rt 


iniMfrd 
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3.0.10 
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£rwN*d 
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Miei 


wtMw 


1*«H»ian: l.U | 


luHOttt 


kp. t, MtX, ir? tm ì? 
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Fig. 3: L'estensione APC è installata e funzionante 



CODE PROFILIMG 

Per poter testare la validità della soluzione APC 
avremo bisogno di un qualche software che ci dia 
una valutazione numerica precisa di quale sia il 
guadagno nell'utilizzo di questa tecnica. Per i nostri 
scopi utilizzeremo xdebug. Neanche a farlo apposta 
si tratta di un'ulteriore estensione di PHP che ci re- 
stituisce fra gli altri il tempo utilizzato per la genera- 
zione dell' opeode. L'installazione di Xdebug segue 
la stessa procedura che abbiamo utilizzato per APC. 
Per gli utenti Linux: 

peci instali xdebug 

per gli utenti Windows è necessario scaricare la dll 
dall'indirizzo http://pecl4win.php. net/ext.php/php_ 
xdebug.dll. 

Anche in questo caso è necessario attivare l'esten- 
sione nel php.ini e riawiare il web server. Uno script 
che potete utilizzare per notare la differenza nella 
generazione dell' opeode è il seguente: 



<?php 


xdebug. 


.start. 


_profiling() 




for($i = 


0; $i 


< 10000; 


$i++) { 


echo 'PHP for life!'; 


} 


xdebug. 


.dump 


)_function_ 


.profileQ; 


xdebug. 


_stop_ 


_profiling(), 




?> 





POTENZA 
DI XDEBUG 

In questo articolo 
abbiamo utilizzato solo 
alcune delle 
caratteristiche di 
questo imponente 
debugger. Con Xdebug 
si possono ottenere 
informazioni 
dettagliate sullo stato 
della memoria, sulla 
velocità dell'esecuzio- 
ne, sull'occupazione 
dello stack e una serie 
di altre informazioni 
incredibilmente utili in 
fase di fine tuning 
dell'applicazione. 
Per Xdebug il sito di 
riferimento è: 
http://www.xdebug.org/ 



<? 



e controllare in output il valore contenuto in opeo- 
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TUOIAPPUNL 



de. Naturalmente si tratta di uno script abbastanza 
semplice, per cui i valori saranno molto piccoli, ma 
può dare già la dimensione di quanto APC possa 
migliorare le prestazioni dei nostri script. Per otte- 
nere una valutazione migliore potete provare con 
script più complessi. 



DEBUGGING DI APC 

Cerchiamo di andare un po' più in profondità per 
capire cosa esattamente succede quando viene 
richiamato uno script e l'estensione APC è attivata. 
Per l'occasione creeremo due script, il primo si 
chiamerà control.php e conterrà il seguente codice: 



<? 

print "<pre>"; 

print_r(apc_cache_info()); 

print "</pre>"; 



il secondo si chiamerà testphp e conterrà il seguen- 
te codice: 

<?php 

xdebug_start_profiling(); 
require_once('utils.php'); 
try { 

$msg = new utils(); 

$msg->messaggio="messaggio di prova"; 
} catch (Exception $e) { 

print $e->getMessage(); 

exitQ; 

> 

for ($i = 0; $i < 5000; $i++) { 
echio str_repeat($msg-> messaggio, rand(l, 3)); 



xdebug_dump_function_profile(); 
xdebug_stop_profiling(); 



avremo ovviamente bisogno di un terzo file chiamo 
utils.php in cui defineremo qualche classe d'ap- 
poggio, in particolare: 



<? 

class utils { 

private $messaggio; 

private function get($property) { 

if($property == "messaggio") { 

return $this->$property; 



else { 
throw new Exception("No such property: 

$property"); 



private function set($property,$value) { 



if($property == "messaggio") { 



$this->$property=$value; 



else { 



?> 



throw new Exception("No such property: 

$property"); 



si tratta anche questo di uno script sufficientemen- 
te banale che non fa altro che ripetere a video un 
messaggio. Lo abbiamo semplicemente complica- 
to un poco creando una classe di supporto, instan- 
ziando qualche oggetto e aggiungendo una funzio- 
ne matematica, semplicemente per innalzare la 
complessità dello script ed ottenere qualche risul- 
tato più utile per i nostri fini. Eseguiamo lo script 
test .php un paio di volte e poi lo script control- 
lo.php che è quello che ci interessa in questo 
momento. La funzione apc_cache_info() ci restitui- 
sce un array contenente le informazione sugli opc- 
dode attualmente disponibili nella cache: 

[cachejist] => 
Array ( 

[0] => Array ( 
[filename] => /home/fabio/public_html 

/ape/test, php 
[device] => 770 

[inode] => 324743 

[type] => file 
[num_hits] => 1 

[mtime] => 1144319900 

[creation_time] => 1144320273 

[deletion_time] => 

[access_time] => 1144320279 

[ref_count] => 
[mem_size] => 5298 ) 
[1] => Array ( 
[filename] => /home/fabio/public_html 

/apc/utils.php 
[device] => 770 

[inode] => 347769 

[type] => file 
[num_hits] => 1 

[mtime] => 1144319636 

[creation_time] => 1144320273 

[deletion_time] => 

[access_time] => 1144320279 

[ref_count] => 
[mem_size] => 6442 ) 
[2] => Array ( 
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[filename] => /home/fabio/public_html 

/ape/controllo. php 
[device] => 770 
[inode] => 385758 



apc_store('stringa di prova', $bar); 



va r_d u m p (a pc_fetch ( 'f oo ' ) ) ; 



[type] => file 



[num_hits] => 



[mtime] => 1144316969 



[creation_time] => 1144320299 



[deletion_time] => 



[access_time] => 1144320299 



[ref_count] => [mem_size] => 1616 ) 

Notate come nella cache vengono inseriti anche gli 
script compilati utils.php e controllo.php, ovvero 
rispettivamente lo script incluso e l'ultimo script 
eseguito. 



GESTIONE DELLA CACHE 

Una volta stabilite le modalità per l'installazione e 
per il testing di APC, l'80% del lavoro è fatto. Lo 
scopo di APC è innalzare le prestazioni utilizzando 
una cache per l'opcode, come già detto più volte. 
È anche vero che questa estensione espone alcuni 
metodi e proprietà per la gestione della cache che 
possono risultare interessanti. Consideriamo il se- 
guente spezzone di codice: 



<? 


define('UNO',l); 


define('DUE',2); 


define('TRE',3); 


echo UNO, DUE, 


TRE; 


?> 



è noto che l'istruzione di define delle costanti è pa- 
recchio lenta. Se volessimo sfruttare a fondo i mec- 
canismi messi a disposizione di APC potremmo 
riscrivere il codice precedente come segue: 



<? 


$constants 


= array( 




'UNO_C 


= > 1, 




■DUE_C 


= > 2, 




TRE_C 


= > 3, 




); 


apc_define 


_constants('numbers\ 


$constants); 


apc_load_constants('numbers'); 


echo UNO_ 


C, DUE_C, TRE_C; 




?> 



un altro esempio interessante d'utilizzo di APC ri- 
guarda le variabili. Consideriamo il seguente script: 



<? 



?> 



come si vede, semplicemente definisce una varia- 
bile $bar e poi conserva il suo contenuto in un'a- 
rea globale della cache di APC attribuendogli 
un'etichetta chiamata 'foo'. Il risultato di questa 
operazione è che adesso il contenuto di foo, non 
solo sarà conservato nella cache, ma addirittura 
potrà essere recuperato da altri script al di fuori di 
quello corrente e della stessa sessione. Il che 
significa che alla prima esecuzione dello script da 
parte di qualunque utente, verrà valorizzata la 
variabile in questione e che tutti gli altri utenti 
potranno recuperare il suo contenuto diretta- 
mente dalla cache senza dover compiere nuove 
operazioni di calcolo. 

Ovviamente questa caratteristica deve essere uti- 
lizzata con una certa attenzione se non si vuole 
incorrere in problemi di sicurezza, ma è altrettan- 
to vero che se utilizzata nel giusto contesto, velo- 
cizza incredibilmente le prestazioni di PHP. Allo 
stesso modo la variabile può essere rimossa dalla 
cache tramite la funzione apc_delete($key). 



CONCLUSIONI 

APC è uno strumento realmente semplice da uti- 
lizzare, ma molto potente. In un ambiente di test, 
dove gli accessi contemporanei, sono in un 
numero necessariamente basso non noterete il 
profondo cambiamento di prestazioni, ma in 
ambienti di produzione laddove i siti generano un 
numero alto di accessi contemporanei vi accorge- 
rete di quanto adottare meccanismi di questo 
genere possono aumentare le prestazioni. 
Certamente, programmare utilizzando una cache 
per l'opcode comporta una dose maggiore di 
attenzione alle politiche di sicurezza, tuttavia 
adottando le dovute accortezze sicuramente ne 
ricaverete un beneficio, specialmente nei sistemi 
moderni dove decisamente non ci sono più pro- 
blemi di limitata disponibilità della memoria e si 
ricercano invece le massime prestazioni in termi- 
ni di risposta da parte delle web application. 



PROGRAMMAZIONE AD OGGETTI 





$bar = 'BAR'; 



In questo articolo non sarà passato 
inosservato che in uno degli esem- 
pi abbiamo utilizzato un elegante 
metodo per la creazione di setter e 
getter universali. Chi è abituato a 
programmare ad oggetti, sa che è 
utile mantenere le variabili locali 
alla classe come private, per poi 



utilizzare dei setter e dei getter per 
attribuire o recuperare un valore 
dalle variabili in questione. 
È proprio il metodo che abbiamo 
usato noi, in più abbiamo proposto 
una soluzione sempre valida, qua- 
lunque siano le proprietà da gesti- 
re all'interno di una classe. 
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completo file compressi con un qualun- 
que tipo di formato 
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E— COME POSSO 
EH^^^H USARE ACCES COME 
CLIENT DI SQL SERVER 2005? pag. 37 

Può essere una soluzione molto comoda 
per creare rapidamente delle maschere o 
gestire un database in modalità struttura 
o inserimento dati. La procedura è sem- 
plicissima 
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I COME POSSO 
EMEM3 SCRIVERE UNA STORED 
PROCEDURE IN MANAGED 
CODE? pag. 38 

A partire da visual studio 2005 è possibile 
scrivere una ST direttamente dal CLR, que- 
sto consente di poter utilizzare un unico 
ambiente per tutte le operazioni 
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VUOI INVIARE UN ESEMPIO? 

Se sei un programmatore esperto ed 
hai risolto un problema, puoi 
aiutare gli altri pubblicando il tuo 
codice. Proponi i tuoi esempi 



io@edmaster.it 




Come contattarci? 

Alla nostra redazione arriva spesso un considerevole 
numero di email riguardante temi specifici. Per con- 
sentirci di rispondere velocemente e in modo adegua- 
to alle vostre domande abbiamo elaborato una FAQ - 
Frequently Ask Question - o risposte alle domande 
frequenti in italiano, di modo che possiate indirizzare 
le vostre richieste in modo mirato. 

Problemi sugli 
abbonamenti 

Se la tua domanda ha a che fare con una delle seguen- 
ti: 

• Vorrei abbonarmi alla rivista, che devo fare? 

• Sono un abbonato e non ho ricevuto la rivista, a 
chi devo rivolgermi? 

• Sono abbonato ma la posta non mi consegna 
regolarmente la rivista, a chi devo rivolgermi? 

Contatta abbonamenti@edmaster.it specificando 
che sei interessato a ioProgrammo. Lascia il tuo indi- 
rizzo email e indica il numero dal quale vorresti far 
partire l'abbonamento. Verrai contattato al più presto. 
Oppure puoi chiamare lo 02 831212 



Problemi sugli allegati 

Se riscontri un problema del tipo: 

• Ho acquistato ioProgrammo ed il Cdrom al suo 
interno non funziona. Chi me lo sostituisce? 

• Ho acquistato ioProgrammo ma non ho trovato il 
cd/dvd all'interno, come posso ottenerlo? 

• Vorrei avere alcuni arretrati di ioProgrammo co- 
me faccio? 

Contatta servizioclienti@edmaster.it 

Non dimenticare di specificare il numero di copertina 
di ioProgrammo e la versione: con libro o senza libro. 
Oppure telefona allo 02 831212 

Assistenza tecnica 

Se il tuo problema è un problema di programmazione 
del tipo: 

• Come faccio a mandare una mail da PHP? 

• Come si instanzia una variabile in c++? 

• Come faccio a creare una pagina ASP.NET 

o un qualunque altro tipo di problema relativo a 



tecniche di programmazione, esplicita la tua 
domanda sul nostro forum: http://forum.iopro- 
grammo.it, uno dei nostri esperti ti risponderà. Le 
domande più interessanti saranno anche pubblica- 
te in questa rubrica. 

Problemi sul codice 
airinterno del CD 

Se la tua domanda è la seguente 

• Non ho trovato il codice relativo all'articolo all'in- 
terno del ed 

Consulta la nostra sezione download all'indirizzo 
http://cdrom.ioprogrammo.it, nei rari casi in cui il 
codice collegato ad un articolo non sia presente nel 
cdrom, senza dubbio verrà reso disponibile sul nostro 
sito. 



Idee e suggerimenti 



Se sei un programmatore esperto e vuoi proporti 
come articolista per ioProgrammo, oppure se hai sug- 
gerimenti su come migliorare la rivista, se vuoi inviar- 
ci un trucco suggerendolo per la rubrica tips & tricks 
invia una email a 
ioprogrammo@edmaster.it 
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COME POSSO RIDIMENSIONARE 
UN'IMMAGINE? 

.NET METTE A DISPOSIZIONE DEI METODI ABBASTANZA SEMPLICI, TUTTAVIA SE NON 
SI VUOLE PERDERE IN QUALITÀ È NECESSARIO ADOTTARE QUALCHE ACCORGIMENTO. 



VISUAL BASIC.NET 



FACCIAMOLO IN C# 

1 Creiamo una forni composta da due PictureBox 
e da un bottone, trasciniamo inoltre sulla stes- 
sa form un componente openFileDialog dalla tool- 
box 



resizeQ; 




poco più in basso scriviamo il nostro metodo 
■ personalizzato per il resize 



private void resize(){ 



( Preoccupiamoci di settare la property SizeMode 
i dell'immagine di sinistra a "Strechlmage" 



pictureBoxl System. Windows I 

agi] HO ^ -3 



S MinimumSize 0; 
Modifiers Private 

E Padding 

E Size 
SizeMode 
Tag 

UseWaitCursc False 
Visible True 

WaitOnLoad False 



0; 0; 0; 
237; 233 
Stretchlnnage \ 



(Name) 

Indicates the nanne used in code 
to identify the object. 



3 Clicchiamo due volte sul bottone per ottenere 
lo scheletro di gestione dell'evento onClick. Il 
codice da inserire sarà il seguente 

private void buttonl_Click(object sender, EventArgs e) 

i 

DialogResult result = openFileDialogl.ShowDialog(); 
if (result == DialogResult. OK) 



{ 



file = openFileDialogl.FileName; 



pictureBoxl. Image = Image.FromFile( 

openFileDialogl.FileName); 



this.Cursor = Cursors.WaitCursor; 



Image olmg = Image. FromFile(file); 
Image oRes = new Bitmap( 

pictureBox2.Width, pictureBox2.Height); 



Graphics oGraphic = 

Graphics. Fromlmage(oRes); 

oGraphic. CompositingQuality = 

System. Drawing.Drawing2D 
.CompositingQuality. HighQuality; 

oGraphic. SmoothingMode = 

System. Drawing.Drawing2D 
.SmoothingMode. HighQuality; 

oGraphic. InterpolationMode = 

System. Drawing.Drawing2D 
.InterpolationMode. HighQuality Bicubic; 

doublé a = (double)pictureBox2.Width 

/ (double)oImg.Width; 

doublé b = (double)pictureBox2.Height 

/ (double)oImg.Height; 
doublé scala = Math.Min(a, b); 
int dx = (int)(oImg.Width * scala), dy = 

(int)(oImg.Height * scala); 
Rectangle oRectangle = new 

Rectangle((pictureBox2.Width - dx) / 2, 
(pictureBox2.Height - dy) / 2, dx, dy); 
Rectangle sRectangle = new Rectangle( 

0, 0, olmg.Width, olmg.Height); 

oGraphic. DrawImage(oImg, oRectangle, 

sRectangle, System. Drawing 
.Graphicsllnit. Pixel); 

oGraphic. Dispose(); 

if (pictureBox2. Image != nuli) 

{pictureBox2.Image.Dispose(); 
pictureBox2. Image = nuli; } 
pictureBox2. Image = oRes; 
this.Cursor = Cursors. Default; 
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COME FUNZIONA? 

Nel pannello di sinistra viene caricata l'immagine 
con i metodi consueti. Nel pannello di destra, per 
confronto carichiamo invece l'immagine con un 
resize più accurato. Inizialmente alla pressione del 
bottone appare una dialog box per la scelta del 
file di immagine da visualizzare. Il pannello di 
destra viene riempito come di consueto tramite il 
metodo Image.FromFile..., per riempire il pannel- 
lo di destra invochiamo invece il nostro metodo 
resize(). In questo metodo viene creato un ogget- 
to di classe Image riempito con il contenuto del- 
l'immagine presa dall'hard disk. Viene poi creato 
un secondo oggetto di tipo Image chiamato oRes. 
Si crea un oggetto Graphics e si settano tutti i pa- 
rametri per ottenere una conversione senza perdi- 
ta di qualità. Quando tutto è settato correttamen- 
te, si assegna l'oggetto oRes alla seconda pic- 
tureBox. Il legame fra l'immagine originale e l'im- 
magine ridimensionata è fornito dalle due linee 

Graphics oGraphic = Graphics. Fromlmage(oRes); 
oGraphic.DrawImage(oImg, oRectangle, sRectangle, 
System. Drawing.Graphicsllnit. Pixel); 



I FACCIAMOLO 
IN VISUAL BASIC 

Ripetere i passi uno e due come in C#, il codice di 
gestione del click sul bottone invece diventa 

Private Sub Buttonl_Click(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles Buttonl. Click 
Dim result As DialogResult 
result = OpenFileDialogl.ShowDialogO 
If result = Windows. Forms. DialogResult. OK Then 
file = OpenFileDialogl.FileName 
PictureBoxl. Image = Image. FromFile( 

OpenFileDialogl.FileName) 
myresize() 

End If 

End Sub 



VARIABILI PRIVATE 

Sia in C# che in VB.net si fa uso di una 
variabile privata file, la si può dichiarare 
nella prima parte del codice come segue: 



Private file As String 



Nel caso di Visual Basic e 



private string file; 



nel caso di C#. 



GLI IMPORT DA UTILIZZARE 

Nel caso di C# 

using System; 

using System. Collections. Generic; 

using System. ComponentModel; 

using System. Data; 

using System. Drawing; 

using System. Drawing. Drawing2D; 

using System.Text; 

using System. Windows. Forms; 



Il metodo myresizeO può essere riscritto nel se- 
guente modo 

Private Sub myresize() 

Me.Cursor = Cursors.WaitCursor 

Dim olmg As Image = Image. FromFile(file) 

Dim oRes As Image = New Bitmap( 

PictureBox2.Width, PictureBox2.Height) 
Dim oGraphic As Graphics = 

Graphics. Fromlmage(oRes) 
oGraphic. CompositingQuality = 

System. Drawing. Drawing2D 
.CompositingQuality. HighQuality 
oGraphic. SmoothingMode = 

System. Drawing. Drawing2D 
.SmoothingMode. HighQuality 
oGraphic. InterpolationMode = 

System. Drawing. Drawing2D 
.InterpolationMode. HighQualityBicubic 



Dim a As Doublé 



(CDbl(PictureBox2.Width) 
/ CDbl(oImg.Width)) 



Dim b As Doublé 



(CDbl(PictureBox2.Height) 
/ CDbl(oImg.Height)) 



Dim scala As Doublé = Math.Min(a, b) 
Dim dx As Integer = olmg.Width * scala 
Dim dy As Integer = olmg.Height * scala 
Dim oRectangle As Rectangle = New 

Rectangle((PictureBox2.Width - dx) / 2, 
(PictureBox2.Height - dy) / 2, dx, dy) 
Dim sRectangle As Rectangle = New 

Rectangle(0, 0, olmg.Width, olmg.Height) 
oGraphic. DrawImage(oImg, oRectangle, 

sRectangle, System. Drawing 
.Graphicsllnit. Pixel) 
oGraphic. Dispose() 

If Not (PictureBox2. Image Is Nothing) Then 
PictureBox2. Image. Dispose() 
PictureBox2. Image = Nothing 



End If 



PictureBox2. Image = oRes 
Me.Cursor = Cursors. Default 



End Sub 
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COME POSSO ESTRARRE 

IL CONTENUTO DI UN FILE ZIP? 

UTILIZZEREMO LE SHARPZIPLIB, LIBRERIE OPENSOURCE CHE GESTISCONO IN MODO EFFICACE 
E COMPLETO FILE COMPRESSI CON UN QUALUNQUE TIPO DI FORMATO 



DA DOVE SI SCARICANO 
LE SHARPZIPLIB? 

L'Uri di riferimento è http://www.icsharpcode.net 
/OpenSource/SharpZipLib/Download.aspx , da cui si 
possono scaricare le librerie già compilate, oppure il 
loro codice sorgente, sempre utile se si vogliono 
approfondire le tecniche di compressione. Il 
progetto è sviluppato utilizzando C#. 



I FACCIAMOLO IN C# 

IDopo aver scaricato le SharpZipLib nella loro 
forma binaria, decomprimo lo zip e aggiungia- 
mo il riferimento alla DLL nel progetto Visual Stu- 
dio. Per farlo utilizziamo il tasto destro del mouse 
sul soluzion explorer, e clicchiamo alla voce "Add 
Reference" 



.igl.FileNarne; 



ing entryName) 
inga in listBox2 . Items) 
are (stringa, entryName, trui 

ick_l (db ject sender, EventA: 

istenza del file... meglio ; 
file == string.Enipty) retu: 
le)) 



I Solution 'Wi tion6' (1 project) 



_, Propertie I 
Referenc 

ai icsh. 

■ Syste 
.JJ Systa 
SÌ Systsjr- 
ai SystaL 
81 Systa 
Qi Systa 
_3 Formi. csl 
,: ^] Program. 



Build 
Rebuild 
Publish... 
Add 



Add Reference.., 



b Reference... 
Set as StartUp Project 
Debug 



Properties >< Remove 

WindowsApplicatioi Renarne 

l]]gj M P fropertis 

Project File 



plicationÈ.csproj 



2 Nella finestra che appare selezioniamo la tab- 
sheet "browse"e sfogliamo l'hard disk alla ricer- 
ca del file ICSharpCode.SharpZipLib.dll, quando lo 
abbiamo trovato selezioniamolo e clicchiamo su 
"Ok" 



or. 



.NET COM Projects Browse Recent 



Cerca in: Nuova cartella J( f ■ |T]- 


^| ICSharpCode . SharpZipLib . dll 




Nome file: | 


V 




Tipo file: Cor Hb; K obf ocx;".exe;".manifest) 


* 



3 Componiamo la form trascinando dalla tool- 
bar, un menu, due listbox, due pulsanti, un 
openFileDialog, e un folderBrowserDialog 






^..J 




'ÌZZ. 



j^ZL 



Organizziamo il menu di modo che sia compo- 
1 sto da una voce "File" e un item "Open" 



¥ x 



Start Page Program. cs Formi. cs* Form l.cs [Design 



EH Form! 



Open 






5 Dichiariamo una variabile privata "file" che 
punterà al nome del file zip da decomprimere 

private string file; 

6 Clicchiamo due volte sulFitem Open, per gene- 
rare lo scheletro di gestione dell'evento. Il no- 
stro codice sarà il seguente 

private void openToolStripMenuItem_Click( 

object sender, EventArgs e) 

{ 

DialogResult result = 

openFileDialog l.ShowDialog(); 
if (result == DialogResult.OK) 

{ 

file = openFileDialogl.FileName; 
zipinfoQ; 



I Poco più in basso scriviamo il metodo zipinfo 
che prowederà a riempire la listboxl con le 



VISUAL BASIC 



/© Components 
J Printing 
Dialogs 

1^ Pointer 

; V] ColorDialog 

^] FolderBrowserDialog 
! ^ FontDialog 

^1 OpenFileDialog 
I j|r] SaveFileDialog 
l Q General 

There are no usable controis in 

this group. Drag an item onto this 

text to add it to the toolbox, 



VReady 
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informazioni recuperate dal file compresso sele- 
zionato al passo precedente 



private void zipinfoQ { 



listBoxl.Items.Clear(); 



listBox2.Items.Clear(); 



button2.Enabled 



false; buttonl.Enabled 
= false; 



ZipInputStream s = new 

ZipInputStream(File.OpenRead(file)); 



ZipEntry theEntry; 



string pathproject=string.Empty; 



string pathimg=string.Empty; 



while ((theEntry = s.GetNextEntryQ) != nuli) 



{ 



NstBoxl.Items.Add(theEntry.Name); 



> 



s.Close(); s=null 



theEntry=null; 



} 



8 Selezioniamo lalistboxl, e clicchiamo due volte 
sull'evento SelectedlndexChanged per gene- 
rarne lo scheletro di gestione del codice. Il nostro 
codice sarà il seguente 



1 1 










strai 


MstBoHl System. Windows. Forms.UstBt * 




mM ^H 




QueryContinueDr 




A 


RegionChanged 










Resize 
RightToLeftChant 








laiBBig 


MstBoHl Sei v 


SelectedValueChc 




5izeChanged 




5tyleChanged 




SysternColorsCha 




_r1 folderBrowserDialogl 


TablndexChange 


V 


SelectedlndeKChanged 

Occurs when the value of the 
Selectedlndex property changes. 




Ib*™ @ 



private void NstBoxl_SelectedIndexChanged( 

object sender, EventArgs e) 

{ 

button2.Enabled = true; 



} 



Clicchiamo due volte sul bottone che ci servirà per 
selezionare i file che vogliamo estrarre dallo zip 
selezionato, e anche di questo evento gestiamone 
lo stato con il seguente codice: 

private void button2_Click(object sender, EventArgs e) 



if (listBoxl. Selectedlndex < 0) return; 


NstBox2.Items.Add(listBoxl.SelectedItem); 


listBoxl. Items.Remove( 

listBoxl. Selectedltem); 


button2.Enabled = false; 


buttonl.Enabled = true; 


} 



Infine clicchiamo due volte sul bottone "estrai" e 
gestiamo la procedura di estrazione 

private void buttonl_Click_l( 

object sender, EventArgs e) 



{ 



//controlliamo l'esistenza del file... meglio 
//se si abilita la condizione anche sul 



//pulsante 



if (file == nuli || file == string. Empty) return; 



if (!File.Exists(file)) return; 



DialogResult result = 

folderBrowserDialogl.ShowDialog(); 
if (result != DialogResult. OK) return; 
string PathTempWorkingFolder = 

folderBrowserDialogl.SelectedPath+"\\"; 



System. IO. FileStream streamWriter; 
//otteniamo lo stream di input dal file 
ZipInputStream s = new ZipInputStream( 

System. IO. File. OpenRead(file)); 
ZipEntry theEntry; 



if (!System.IO.Directory.Exists( 

PathTempWorkingFolder)) 
//pathWorkingFolder+"\\temp")) 
System. IO. Directory.CreateDirectory( 

PathTempWorkingFolder); 



int num = 0; 


while ((theEntry = s.GetNextEntry()) 


= nuli) 


{ 


if (isSelected(theEntry.Name)) 


{ 



if (File.Exists(PathTempWorkingFolder 

+ theEntry. Name) && MessageBox.Show( 

"Il file " + PathTempWorkingFolder + "\\" + 

theEntry. Name + " già esiste nella cartella, 

sovrascriverlo?", "Info", 

MessageBoxButtons.YesNo, 

MessageBoxIcon.Question) 

= = DialogResult. No) 

continue; 

num+ + ; 



streamWriter 



System. IO. File. Create( 
PathTempWorkingFolder 
+ theEntry.Name); 



int size = 2048; 



byte[] data = new byte[2048]; 



while (true) 
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size = s.Read (data, 0, data.Length); 



if (size > 0) 



{ 



streamWriter.Write(data, 0, size); 



else 



break; 



streamWriter.Close(); streamWriter = nuli; 



> 



s.Close(); s = nuli; theEntry = nuli; 
MessageBox.Show("Estratti " + num + " file", 

"Info", MessageBoxButtons.OK, 
MessageBoxIcon. Information); 

GC.CollectQ; 

} 

Scriviamo il metodo isSelected che controlla se una 
entry del file deve essere realmente estratta 



private bool isSelected(string entryName) 


{ 


foreach (string stringa in NstBox2.Items) 


{ 


if (String. Compare(stringa, entryName, true) 
==0) return true; 


} 


return false; 


} 



COME FUNZIONA 

La pressione sul menu open apre una dialog box e 
riempie il contenuto della variabile privata "file" 
con il nome del file compresso su cui vogliamo 
agire, a questo punto passa il controllo al metodo 
zipinfo(). Questo metodo effettua un ciclo di while 
sulle entry che compongono il file in questione e 
riempie la listboxl. La pressione sul secondo pul- 
sante sposta i nomi dei file contenuti in listboxl da 
questa a listbox2. La pressione del tasto estrai 
effettua di nuovo un ciclo sul file e se una delle 
entry viene trovata anche in listbox2 allora la 
estrae. 



I FACCIAMOLO 
IN VISUAL BASIC 

I passi da uno a 5 rimangono identici a quelli della 
procedura C#, la dichiarazione della variabile che 



conterrà il nome del file da controllare diventerà 

Private myfile As String 

clicchiamo sulla voce "Open" per creare il codice di 
gestione dell'evento, che diventerà 

Private Sub OpenToolStripMenuItem_Click(ByVal 

sender As System. Object, ByVal e As 

System. EventArgs) Handles 

OpenToolStripMenuItem. Click 



Dim result As DialogResult = 

OpenFileDialogl.ShowDialogO 


If (result = 


Windows. Forms.DialogResu 


It.OK) 
Then 


myfile = 


OpenFileDialogl.FileName 




zipinfo() 


End If 


End Sub 



GLI IMPORT DA UTILIZZARE IN VISUAL BASIC 

Imports ICSharpCode.SharpZipLib 

.Zip.Compression 
Imports ICSharpCode.SharpZipLib 

.Zip.Compression.Streams 



È necessario aggiungere nella classe le 
seguenti linee 

Imports ICSharpCode.SharpZipLib 

Imports ICSharpCode.SharpZipLib.zip Imports System. IO 



Scriviamo il metodo zipinfoO 



Private Sub zipinfo() 



ListBoxl.Items.ClearQ 



ListBox2.Items.Clear() 



Button2.Enabled = False 



Buttonl.Enabled = False 



Dim s As ZipInputStream = New 

ZipInputStream(File.OpenRead(myfile)) 



Dim theEntry As ZipEntry 



Dim pathproject As String = String. Empty 
Dim pathimg As String = String. Empty 



theEntry = s.GetNextEntry 



Do While Not theEntry Is Nothing 



ListBoxl.Items.Add(theEntry.Name) 



theEntry = s.GetNextEntry 



Loop 



s.CloseQ 



s = Nothing 



theEntry = Nothing 



End Sub 
Gestiamo l'evento SelectedlndexChanged 
button2.Enabled = true; 
Scriviamo il codice di gestione relativo all'evento 
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onclick sul pulsante che vogliamo usare per sele- 
zionare i file da estrarre 



Private Sub Buttonl_Click(ByVal sender As 

System.Object, ByVal e As System. EventArgs) 
Handles Buttonl. Click 


If ListBoxl.Selectedlndex < Then 


Return 


End If 




ListBox2.Items.Add(ListBoxl.SelectedItem) 


ListBoxl.Items.Remove(ListBoxl.Selectedltem) 


Button2.Enabled = False 


Buttonl. Enabled = True 


End Sub 



GLI IMPORT DA UTILIZZARE 
INC# 

E 1 necessario aggiungere nella classe le seguenti linee 



using System; 




using System. Collections.Generic; 


using System. ComponentModel; 


using System. Data; 


using System. Drawing; 


using System. Text; 


using System. Windows. Forms; 


using ICSharpCode.SharpZipl_ib.zip; 


using ICSharpCode.SharpZipLib.Zip.Compression; 


using ICSharpCode.SharpZipLib.Zip.Compression 


.Streams; 


using System. IO; 



Scriviamo il codice relativo al bottone estrai 

Private Sub Button2_Click(ByVal sender As 

System.Object, ByVal e As System. EventArgs) 
Handles Button2. Click 
'controlliamo l'esistenza del file... meglio se si 
abilita la condizione anche sul pulsante 
If (myfile Is Nothing Or myfile Is 

String.Empty) Then 
Return 

End If 

If Not (File.Exists(myfile)) Then 

Return 

End If 

Dim result As DialogResult = 

FolderBrowserDialogl.ShowDialogO 
If Not (result = 

Windows. Forms. DialogResult. OK) Then 
Return 
End If 



Dim PathTempWorkingFolder As String = 

FolderBrowserDialogl.SelectedPath + "\" 



Dim streamWriter As System. IO. FileStream 
'otteniamo lo stream di input dal file 
Dim s As ZipInputStream = New 

ZipInputStream(System.IO.File.OpenRead( 

myfile)) 
Dim theEntry As ZipEntry 
If Not (System. IO. Directory. Exists( 

PathTempWorkingFolder)) Then 
System. IO. Directory.CreateDirectory( 

PathTempWorkingFolder) 



End If 

Dim num As Integer = 
theEntry = s.GetNextEntry() 
Do While Not theEntry Is Nothing 
If (isSelected(theEntry.Name)) Then 
streamWriter = System. IO. File. Create( 
PathTempWorkingFolder + theEntry.Name) 
Dim size As Integer 
Dim mydata As Byte() 
Do While (True) 

size = s.Read(mydata, 0, 

mydata. Length) 
If (size > 0) Then 

streamWriter.Write(mydata, 0, size) 

Else 

Stop 
End If 

streamWriter.Close() 
streamWriter = Nothing 
Loop 



num = num + 1 
End If 

theEntry = s.GetNextEntry() 
Loop 
s.Close() 
s = Nothing 
theEntry = Nothing 
MessageBox.Show( 

"Estratti " + num + " file", 

"Info", MessageBoxButtons.OK, 

MessageBoxIcon. Information) 

GC.CollectQ 

End Sub 

Private Function isSelected( 

ByVal entryName As String) As Boolean 
Dim stringa As String 
For Each stringa In ListBox2.Items 

If (String. Compare(stringa, entryName, 

True) = 0) Then 
Return True 
End If 
Next 



Return False 



End Function 
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COME POSSO USARE ACCESS COME 
CLIENT DI SQL SERVER 2005? 

PUÒ ESSERE UNA SOLUZIONEWIOLTO COMODA PER CREARE RAPIDAMENTE DELLE MASCHE- 
RE O GESTIRE UN DATABASE IN MODALITÀ STRUTTURA O INSERIMENTO DATI. LA PROCEDU- 
RA È SEMPLICISSIMA 



1 



Prima di tutto è necessario avviare access e 
scegliere file /nuovo 



□ Nuovo,,, CTRL+IM 


Finestra ? 


fi^ Apri,,. CTRL+F12 

■:hiudi 
y MA1U5C+F1J 




| 

» 


UDocumen; ,.\testl,adp 

2 \Docum8i': ,..\test.adp 

3 \. . ,\ioProg_DVD_45C5.adp 
ì\,..\ioProg_DVD_42CS.adp 


Esci 



2 Dal menu laterale scegliete "Progetto dati 
Esistente" se volete utilizzare un db già 
presente in SQL Server, altrimenti "Progetto Dati 
Nuovi" se volete creare un nuovo db su SQL Server 







Nuovo file ▼ x 
Apri file 


testl.adp 

test.adp 

ioProg_DVD_45C5 .adp 

ioProg_DVD_42CS.adp 
L* Altri File... 
Nuovo 
l*[] Database vuoto 
l*|] Pagina di accesso ai dati vuota 
l£|] Progetto (dati esistenti) 
|*3 Progetto (dati nuovi) 
Nuovo da file esistente 


j|Q Scegli file... 
Nuovo da modello 

!*[] Nodelli generali.., 

^ Mode' nsoft. corri 



) Scegliete la posizione in cui salvare il file di 
' progetto 






Ornila? ^T » - " , ~~ - Vi^Ktfl ■ 







■»»*«* |t«tL,«fc 



"3 
"3 



^z: 



4 Inserite le impostazioni di connessione, 
avendo cura di aggiungere il nome dell'istanza 
di SQLServer a cui connettersi immediatamente 
dopo il suo nome preceduta dal simbolo "\" senza 
le virgolette 



S Proprietà di Data Link 



Connessione | Avanzate | Tutte le proprietà | 

Per connettersi ai dati di SQL Server, specificare quanto segue: 

1 . Selezionare o specificare un nome di server: 
|JAC0XF^ gil^3!ffl5g ~~ TJ Aggiorna 

2. Inserire le informazioni necessarie per l'accesso al server: 
C Utilizza protezione integrata di Windows NT 

(* Utilizza password e nome utente specifici: 
Nome utente: [sa 
Password: < ^« 

\~ Nessuna password |~~ Co ataggio password 

3. (* Selezionare il database sul server: 



|ioProg3 



~U 



C Associa file di database con nome: 



File da ul 



_l 



'V-: :;';;:: :. ; : : connessione 



5 A questo punto potete lavorare sulle tabelle in 
modo consueto come siete abituati a fare in un 
progetto Access 



bP test 2 : Progetto - ioProg3 (formato file di Access 2000) [-~][n~||X 



I^Apri ^Struttura %] Nuovo I : 



Oggetti 


(101 Description 
(101 Macrocategoria 
[Hil Sottocategoria 
[Hil utenti 


H Tabelle 


^ Query 

°^ Diagrammi di data . . . 

EU Maschere 

9 Report 

^y Pagine 

3 Macro 

*§ Moduli 


Gruppi 


(#i Preferiti 
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COME POSSO SCRIVERE UNA STORED 
PROCEDURE IN MANAGED CODE? 



A PARTIRE DA VISUAL STUDIO 2005 E SQL SERVER 2005 E POSSIBILE SCRIVERE UNA SP 
DIRETTAMENTE DAL CLR, QUESTO CONSENTE DI POTER UTILIZZARE UN UNICO AMBIENTE 
PER TUTTE LE OPERAZIONI 



VISUAL BASIC.NET 



I FACCIAMOLO IN C# 

1 Creiamo un nuovo progetto e scegliamo "Class 
Library" e diamo al progetto un nome 
significativo, ad esempio: SQLServerHostTest 




•jttrt#vt i-oiKti. . 



il c-mrtrfri bfads -y 



r.jr.rtTlYnitt 
'.lajsLfcf*yi 



r «inr gnaiifW ysfffriit 



|tWa6*»L.jJfefw 




w*i ItTDOflh cwrtng ■ Uy-hnctn^ Biù H*adef stop-fa) 1 ^«ep usta Vbu^ -L# *>J -JX i«™ 

MMftpW 

Vt»1« KiC Ulrek Jickl * d (jimt 

Mm, ffc Mw ?IIU ;.ì:?fl:r£ CMT <3«t« Kli mi fi Jy fi** Imiti wi^i ,-f(irttWK »*h 

faniMPtebon to «few voti to get stsrtcd uiv>g, tammi end CLtstomzra ngt* *¥*t ' lay (lati. 

J«h.«UB , Bl 4 Yov*i-r Jet JpJw. a pJ «H )w limi pinta».. UMitb, w uu^urn uiJ ita.ii daùpr 



2 sostituiamo il nome della classe base con uno 
di nostro gradimento 

namespace SQLServerHostTest 

J 

public class HostFunctions 



{ 



GLI IMPORT DA USARE IN C# 



Nella prima parte della classe è necessario 
aggiungere 

using System; 

using System. Collections.Generic; 



using System. Text; 



using System. Data; 



using System. Data. SqlClient; 



using Microsoft.SqlServer; 



using Microsoft. SqlServer.Server; 



3 Aggiungiamo la funzione che sarà "Hostata" in 
SQLServer 

namespace SQLServerHostTest 

i 

public class HostFunctions 



[Microsoft. SqlServer.Server.SqlProcedure()] 
public static void GetDescription(string nome) 

J 

using (SqlConnection connection = new 

SqlConnection("context connection=true")) 

{ 

connection. Open(); 

SqlCommand command = new SqlCommand( 

"SELECT * FROM Description " + 

"WHERE NomeFile like '%"+ @nome 

+"%"', connection); 

command. Parameters.AddWithValue( 

"@nome", nome); 
SqlContext.Pipe.ExecuteAndSend( 

command); 
} 



> 



4 Clicchiamo sul menu "Project SqlServerHost- 
Test Properties" e settiamo il path dove voglia- 
mo che il compilatore salvi la nostra nuova dll. 
Quando siamo certi che tutto sia idoneo ai nostri 
scopi compiliamo il progetto tramite il tasto F6 



ServerHostTest - Microsoft Visual C# 2005 Express Edition 



Edit View Project Build Debug Data Tools 

I T j _] Add Windows Form... 

_] Add User Control... 

**$ Add Class... 

| Add New Itenn... 
e are no usabli — 

Draganitem _j Add Existing Itenn.. 
add it to the 

i New Folder 



Shift+Alt+C 
Ctrl+Shift+A 
5hift+Alt+A 



Window Community 
: Classi. cs Start P 



jp 5how AH Files 
Add Reference... 
Add Web Reference. . . 
Set as StartUp Project 



: . vr. -....: 



snce Paths 



Signing 



General 

Conditional coi 
D Define DEE 

Define TRA 

1 I Allow unsal 
\Z\ Optimize ce 

Errors and warning; 

Warning level: 

Suppress warn 

Treat warnings as e 

None 

O Specific wa 

AH 

r>i ih| -" ih 



5 Avviamo SQL Server Management Studio e 
clicchiamo con il tasto destro sul database che 
vogliamo usare come test, selezionando "New 
Query" 
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File Edit View Tools Window Help 


^ New Query L j J A £ ^ - 


v- ■ ^ *^ ti l "1 


ESSUS^^^^H^^^^^XEl 




JACOXP\SQLEXP...QLQuery2.sql* 


& ? J 


m 


BLY asmHelloWorld FROH 

RE dbo GetTheFile 
char ;200 

HE [asitiHe Ilo World] . [3Q 


- _j Databases 

+ , master 
+ i model 
(3 ij msdb 
+ tempdb 

! * 
+ New Database,,, 

Jatabase as ► 

3 Tasks ► 

gì q 

+ _ Renarne 
1 IJ «j Delete 
+ _j Secur 
9 ^ Serve Refresh 
+ __i Replic Properties 


3,1399 -sa) 




_J Messages 


+ _j Management 




Command(s) compieteti succes: 



i Nella finestra della query digitiamo 



CREATE ASSEMBLY asmHelloWorld FROM 

'c:\SqlServerHostTest.dll' 

7 Eseguiamo la query tramite il bottone execute, 
cancelliamola e scriviamone un'altra 

CREATE PROCEDURE dbo.GetTheFile( 

@nome as nvarchar(200) ) 
AS EXTERNAL NAME [asmHelloWorld]. [ 

SQLServerHostTest.HostFunctions].[ 
GetDescription]; 



8 



Proviamo la nuova stored procedure con 



USE [ioProg3] 



GO 



DECLARE@return_value int 



EXEC @return_value = [dbo]. [GetTheFile] 



@nome = N'Flash' 



SELECT 'Return Value' = @return_value 



GO 



COME FUNZIONA? 

Abbiamo creato una DLL al cui interno è "immagaz- 
zinata" una query. In SQL Server abbiamo registra- 



to la DLL come assembly esterno. Abbiamo poi crea- 
to una procedure il cui codice non è espresso da 
una funzione programmatica all'interno di SQL ma 
è prelevato direttamente dalTassemblv. 



I FACCIAMOLO 
IN VISUAL BASIC 

Tutti i passi rimangono identici ai precedenti, 
cambia esclusivamente il codice da implementare 
nel progetto, che diventa: 

amespace SQLServerHostTestl 
Public Class HostFunctions 

< Microsoft. SqlServer.Server.SqlProcedure()> _ 
Public Shared Sub GetDescription(ByVal nome 

As String) 
Dim command As SqlCommand 
' Connect through the context connection 
Using connection As New SqlConnection( 

"context connection=true") 
connection. Open() 
command = New SqlCommand( _ 
"SELECT * from description " & _ 
"WHERE NomeFile like '%" & 

"@nome" & "%'", connection) 
command. Parameters.AddWithValue( 

"@nome", nome) 
' Execute the command and send the 

results directly to the client 
SqlContext.Pipe.ExecuteAndSend( 

command) 
End Using 

End Sub 

End Class 
End Namespace 



GLI IMPORT DA USARE IN VB.NET 



Nella prima parte della classe è necessario 
aggiungere 

using System; 

using System. Collections.Generic; 



using System. Text; 



using System. Data; 



using System. Data. SqlClient; 
using Microsoft. SqlServer; 
using Microsoft. SqlServer.Server; 



LA TABELLA ESISTE? 



Sfruttiamo il controllo sugli errori per 
capire se l'oggetto esiste 

Private function TabellaPresente 

(TableName as String) As Boolean 
Dim strConn As String 



Dim rs As Record set 



strConn = "Provider = 
OLEDB.4.0; Data Source = 
"&_"C: \esempio.mdb" 



Microsoft. Jet 



Set rst=New Record set 



On Error Resumé Next 



rst.Open tableName, strConn, 



adOpenForwardOnly, 
adl_ockReadOnly,adCmdTable 
TabellaPresente = Not Cbool(Err.Number) 

On Error GoTo 
End Function 
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INSTANT MESSAGING 
CON MSN E .NET 

DOTMSN È UNA LIBRERIA OPEN SOURCE PER UTILIZZARE LE FUNZIONALITÀ DI MSN 
MESSENGER IN UNA QUALUNQUE APPLICAZIONE .NET, SIA WINDOWS CHE WEB 
VEDIAMO COME DOTARE IL NOSTRO SOFTWARE DI UNA CHAT ONE TO ONE 





REQUISITI 



Me.UMiJ.UMU.tUm 



U- Conoscenze medie 
diC* 



mmm 



I 



.NET framework SDK 
2.0, Visual Studio .NET, 
DotMSN 



.■>:;■; ; r 



MSN Messenger è un client di instant mes- 
saging per la piattaforma Windows, così 
diffuso che i suoi utenti lo chiamano 
semplicemente MSN, oppure il Messenger. Esiste 
anche una versione web dell'applicazione, chiama- 
ta MSN Web Messenger. MSN Messenger è basato 
sul protocollo MSNR che sta per Mobile Status Noti- 
fication Protocol, ed è basato su TCR o eventual- 
mente su http quando è necessario utilizzare un 
proxy. Il protocollo MSNP si connette al servizio 
MSN Messenger sulla porta 1863 di messenger.hot- 
mail.com, ed è attualmente giunto alla versione 12 
(MSNP12) che corrisponde alla versione 7.5 del 
client, mentre il successivo, attualmente in beta ad 
invito, chiamato Windows Live Messenger, utilizzerà 
la versione 13. Il protocollo MSNP non è di pubblico 
dominio, a parte le prime versioni pubblicate da 
Microsoft in un Internet Draft. Dunque molti utenti 
si sono mes si a sniffare il traffico prodotto durante 
una sessione MSN e, a colpi di riverse engineering, 
hanno pubblicato versioni non ufficiali del pro- 
tocollo. Attualmente la fonte più autorevole, dove 
trovare informazioni sul formato dei comandi 
MSNR è il sito web http://www.hypothetic.org/docs 
/msn/index.php. 



DOTMSN 

Studiando il protocollo MSNP è possibile creare 
un'applicazione per autenticarsi al servizio, aprire 
conversazioni con gli utenti registrati, ed effettuare 
tutte le operazioni permesse da MSN Messenger. Il 
compito non sarebbe impossibile, ma non è nem- 
meno così semplice. Per fortuna esistono librerie 
che implementano il protocollo, fra le quali dot- 
MSN, che fra l'altro adesso è anche open source e 
quindi è possibile studiare il codice sorgente. Se 
invece si vuole solo sfruttare la libreria per integrare 
in un'applicazione le funzionalità di instant messa- 
ging di MSN Messenger, basta utilizzare la libreria 
dotMSN e magari la completa documentazione for- 
nita a corredo, cosa che faremo in questo articolo. 
DotMSN non necessita della presenza del client 



MSN Messenger installato, in quanto si connette 
direttamente all'host del servizio, e colloquia con il 
suo protocollo. L'unica pecca, al momento, è il sup- 
porto giunto alla versione MSNP9, ma per le funzio- 
nalità fondamentali è più che sufficiente. 



URI PROGETTO 

coni DOTivism 

Per scrivere un'applicazione che utilizzi dotMSN, 
utilizzeremo Visual Studio .NET 2005, ma la ver- 
sione 2.0 di dotMSN funziona senza nessuna diffe- 
renza anche con il .NET framework 1.1. È necessa- 
rio innanzitutto scaricare dotMSN dal sito indica- 
to in bibliografia, ma presente anche sul CD alle- 
gato alla rivista, e dopo aver creato un'applicazio- 
ne Windows, in questo caso C#, aggiungere la 
libreria fra i riferimenti del progetto stesso. Dun- 
que basta cliccare con il tasto destro su References 
{Riferimenti nella versione italiana) e dal menu 
contestuale scegliere la voce Add Reference (Ag- 
giungi Riferimento). A questo punto basta sfoglia- 
re il file system, e ricercare l'assembly XihSolu- 
tions.DotMSN.dll (Figura 1). 




Fig. 1: Aggiungere il riferimento a DotMSN 

La libreria DotMSN apparirà nel solution explorer 
di Visual Studio 2005 fra i riferimenti del progetto 
(Figura 2). 
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Solution Explorer - Solution 'MyM... t ^ X 




a Jl 




^ Solution 'MyMSN' (1 project) 




- J3 MyMSN 






_j References 








J System 








J System. Data 








-& System. Drawing 








J System. Windows. Forms 








J System. XML 








B| 








=j] App.ico 








j] AssemblyInfo.es 






Il |J Formi, cs 



F/gf. 2: Riferimento all'assembly DotMSN 



LA CLASSE MESSENGER 

La classe Messenger di DotMSN è forse la classe 
principale del pacchetto, in quanto fornisce il pun- 
to d'ingresso per programmare un client MSN. La 
classe Messenger è una classe facade che nasconde 
tutte le astrazioni di basso livello, ad esempio il pro- 
cessamento dei messaggi in arrivo e in uscita, la 
gestione del protocollo MSNR e così via, utilizzando 
una gestione ad eventi in maniera da informare le 
classi che sono interessati ad essi. In tal modo i pro- 
grammatori potranno semplicemente sottoscrivere 
un evento della classe e gestirlo come meglio credo- 
no. Inoltre tramite la lettura di semplici proprietà si 
potrà verificare lo stato del client, ad esempio la 
proprietà Connected restituisce true se c'è una con- 
nessione al server MSN, mentre Owner, che deriva 
dalla classe Contact, rappresenta l'utente connesso, 
di cui si può ricavare il nome visualizzato, leggendo 
la proprietà Nome, o tutte le altre informazioni sul- 
l'utente: 

if(messenger. Connected) 
{ //connesso al servizio 

string name=messenger.Owner.Name; 

MessageBox.Show("Accesso avvenuto come "+name); 



Nella nostra applicazione di esempio partiremo 
dunque proprio dall' aggiungere un campo di classe 
Messenger alla form di avvio dell'applicazione. 



CONNESSIONE 
AL SERVIZIO 

La prima funzionalità necessaria al funzionamento 
dell'applicazione è naturalmente quella che effettua 
l'accesso al servizio. Dunque implementiamo una 
Form che apparirà subito sopra la barra delle appli- 
cazione alla pressione della voce Accedi del menu, 
come in Figura 3. 



La gestione dei valori inseriti nelle TextBox viene fat- 
ta alla chiusura della form stessa, leggendoli dalla 
classe principale LaunchForm, se si è premuto il ta- 
sto Accedi. Ciò è possibile impostando la proprietà 
DialogResult del pulsante al valore DilogResult.OK, 
mentre al contrario il valore della proprietà per il 
pulsante Annulla sarà impostato a DialogResult 
.Cancel In tal modo per gestire l'accesso potremo 
scrivere un metodo come il seguente: 

ConnectForm connect = new ConnectForm( 
messenger.Credentials. Account, 

messenger.Credentials. Password); 
connect. Parent = nuli; 

if (connect. ShowDialog() == DialogResult. OK) 
{ if (messenger.Connected) 

{ SetStatus("Disconnessione in corso..."); 
messenger.Disconnect(); } 

messenger.Credentials.Account = connect. Username; 

messenger.Credentials. Password = connect. Password; 



SetStatus("Connessione in corso..."); 
messenger. Connect(); 



} 



User | user@mail.it 


Password 




Annulla 


Accedi 




irt - MSDN Library ... IT * 


w 



Fig. 3: La form di accesso al servizio 

Come potrete notare, la prima condizione da con- 
trollare è se si è già connessi al servizio, tramite la 
proprietà Connected, ed in caso affermativo discon- 
nettersi. Per la connessione invece si impostano i 
valori di Account e Password leggendoli dalla form di 
connessione e subito dopo invocando il metodo 
Connect. Ma cosa avviene se la password è errata? 
Oppure se non è possibile comunque connettersi, o 
ancora se viceversa la connessione avviene positiva- 
mente? È necessario gestire gli eventi della classe 
Messenger e delle sue proprietà. 



GLI EVENTI 

DI MESSENGER 

Facciamo un passo indietro e vediamo la sottoscri- 
zione degli eventi della classe Messenger che ci servi- 
ranno a capire cosa sta succedendo. 

messenger = new Messenger^); 
messenger.Credentials. ClientlD = "mymsn@mymsn"; 
messenger.Credentials. ClientCode = "MyMSN-0.1"; 
messenger. Nameserver.Signedln += new 

EventHandler(Nameserver_SignedIn); 





GLOSSARIO 



CLIEMTID 

E CLIENTCODE 

Il client identif ier ed il 
client code, 
permettono di dare 
una firma identificativa 
al client connesso alla 
rete MSN. In questo 
modo le software 
house possono avere 
un'identificazione del 
proprio prodotto, 
chiedendo ufficialmen- 
te a Microsoft una 
licenza contenente i 
due valori. 
Per emulare il client 
Microsoft MSN 
Messenger è possible 
usare come ClientlD 
msmsgs@msnmsgr.com e 
come ClientCode 
Q1P7W2E4J9R8U3S5. 



E SE CE 
IL PROXY? 

È possibile impostare 
tutti i parametri relativi 
al proxy da voi utilizza- 
to, grazie alle proprietà 
Messenger. Connectivity 
che restituisce un og- 
getto ConnectivitySet- 
tings. Ad esempio le 
proprietà per imposta- 
re nome del proy, por- 
ta, username e pass- 
word sono rispettiva- 
mente ProxyHost, Pro- 
xyPort, ProxyUsername 
e ProxyPassword. 
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GLOSSARIO 



DOTMSM 

DotMSN è la libreria 

per sfruttare le 

funzioni di MSN 

Messenger nelle 

applicazioni .NET, è 

open source ed è 

gratuita, ed inoltre è 

liberamente 

utilizzabile sia in 

applicazioni 

commerciali che non 

commerciali. 

L'indirizzo web da cui è 

possibile effettuare il 

download è 

http://www.xi hsolutions 

.net/dotmsn/download 

.html . 



messenger. Nameserver.SignedOff += new 

SignedOffEventHandler(Nameserver_SignedOff); 
messenger. Nameserver.AuthenticationError + = 

new.HandlerExceptionEventHandler( 

Nameserver_AuthenticationError); 

messenger. NameserverProcessor.ConnectionEstablish 

ed += new EventHandler( 

NameserverProcessor_ConnectionEstablished); 

messenger. NameserverProcessor.ConnectionClosed 

+ = new EventHandler( 

NameserverProcessor_ConnectionClosed); 

messenger. NameserverProcessor.ConnectingException 

+ = new ProcessorExceptionEventHandler( 

NameserverProcessor_ConnectingException); 

messenger. NameserverProcessor.ConnectionException 

+ = new ProcessorExceptionEventHandler( 

NameserverProcessor_ConnectionException); 

messenger. ConversationCreated += new 

ConversationCreatedEventHandler( 
messenger_ConversationCreated); 

Tramite le proprietà ClientlD e ClientCode si può 
dare una firma al nostro client, per ulteriori infor- 
mazioni vedi il box relativo. Successivamente sot- 
toscriviamo alcuni eventi necessari a controllare il 
funzionamento del client ed il suo stato. La 
proprietà Nameserver di Messenger restituisce un 
NSMessageHandler, cioè un oggetto che si occupa 
di gestire il protocollo MSNP. L'evento Signedln si 
verifica quando è terminata la fase di autenticazio- 
ne ed il server ha dato autorizzazione all'accesso, 
quindi da questo momento si è connessi alla rete 
MSN. Il metodo che gestisce l'evento è il seguente: 



Offe un evento che si verifica alla disconnessione, 
ed il metodo Nameserver JSignedOff non fa altro 
che mostrarci un messaggio per avvisarci di ciò, e 
della ragione della disconnessione. 
Infatti il metodo ha la firma 

void Nameserver_SignedOff( 

object sender, SignedOffEventArgs e) 

L'oggetto SignedOffEventArgs possiede una 
proprietà SignedOffReason, che può assumere uno 
dei valori dell'omonima enumerazione, vale a dire 
None, che avviene generalmente se siamo noi a 
chiedere la disconnessione, o se ad esempio cade 
la connessione alla rete, OtherClient se la connes- 
sione al servizio con lo stesso utente è avvenuta da 
un altro client, ServerDown se è il server è andato 
giù. Se la coppia Username-Password non è valida, 
si ha naturalmente un errore di autenticazione, ge- 
stibile dall'evento AuthenticationError. La pro- 
prietà NameserverProcessor di Messenger, restitui- 
sce invece un oggetto NSMessageProcessor, classe 
che si occupa di gestire FIO con il Notification 
Server, cioè il server che gestisce i messaggi ed il 
loro contenuto. La classe NSMessageProcessor 
deriva dalla SocketMessageProcessor, della quale 
andremo a gestire gli eventi di connessione e 
disconnessione. Infine gestiremo l'evento Con- 
versationCreated della classe Messenger, evento 
che si verifica all'avvio di una conversazione con 
un contatto, sia iniziata localmente, che per un 
invito remoto, torneremo sull'argomento nel para- 
grafo relativo alle conversazioni. 



IL PROGETTO 

Sul CD o sul sito web di 
loProgrammo trovate il 
codice completo 
dell'applicazione. Esso 
è costituito da una so- 
luzione per Visual Stu- 
dio 2005, ma natural- 
mente è possibile com- 
pilare da riga di coman- 
do per mezzo del com- 
pilatore esc fornito con 
il framework .NET 2.0 



void Nameserver_SignedIn(object sender, EventArgs e) 
{ SetStatus("Online: " + messenger.Owner.Name); 
messenger.Owner.Status = PresenceStatus. Online; 
notifyIcon.ShowBalloonTip(4000, "Accesso 

avvenuto", "Effettuato l'accesso come 
"+messenger.Owner.Name, ToolTipIcon.Info); 
EnableMenuItem(false, accediToolStripMenuItem); 
EnableMenuItem(true, contattiToolStripMenuItem); 
Invoke(new UpdateContactl_istDelegate( 

UpdateContactlist)); 
} 



Oltre ad operazioni puramente grafiche, come im- 
postare la label che indica lo stato di connessione, 
mostrare un BalloonTip, ed abilitare i menu che è 
possibile utilizzare da questo momento, il metodo 
imposta la proprietà Owner.Status al valore Presen- 
ceStatus. Online, in questo modi nostri contatti po- 
tranno accorgersi di noi. L'elenco di contatti viene 
ottenuto a questo punto tramite il metodo Upda- 
teContactList, chiamto tramite Invoke ed un dele- 
gate perché è necessario eseguirlo nel thread della 
nostra applicazione e non in quello della classe 
che genera l'evento Signedln. Al contrario Signed- 



LA LISTA DEI CONTATTI 

Una volta connessi posiamo ottenere dal server del 
servizio MSN la lista dei nostri contatti, aggiungen- 
doli come voci di sottomenu del menu principale 
Contatti. 



private void UpdateContactlist() 
{ if (messenger. Connected == false) 
return; 

contattiToolStripMenuItem. DropDownItems.Clear(); 
ToolStripMenuItem item = new ToolStripMenuItem(); 
foreach (Contact contact in messenger.Contactl_ist.AII) 
{ item = new ToolStripMenuItem(); 
item.Text = contact. Name; 
item.Tag = contact; 
contact. ContactOnline += new 

Contact. ContactChangedEventHandler( 
contact_ContactOnline); 
item. Click += new EventHandler(item_Click); 
contattiToolStripMenuItem. DropDownItems.Add( 

item); } 
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per ottenere la lista dei nostri contatti basta utiliz- 
zare la proprietà ContactList.All che restituisce un 
enumeratore, utilizzabile in un ciclo foreach. Per 
ogni oggetto Contact della lista andremo a gestire 
l'evento ContactOnline, per sapere se e quando il 
contatto ha effettuato l'accesso. Il metodo che ge- 
stisce l'evento è il seguente: 

void contact_ContactOnline(object sender, EventArgs e) 
{ Contact contact = sender as Contact; 
if (contact != nuli) 
{ notifyIcon.ShowBalloonTip(3000, "Contatto 

online", contact. Name+" ha effettuato 
l'accesso", ToolTipIcon.Info); } 



> 



L'oggetto Con tact è ottenuto dall'oggetto sender, di 
cui possiamo ottenere informazioni come il nome 
visualizzato, la mail dell'account, lo stato, e così 
via. In questo caso mostriamo un messaggio con 
lo Screen Name del nostro contatto. 



AVVIARE 

UNA CONVERSAZIONE 

Una conversazione può essere iniziata localmente, 
invitando un contatto, oppure a partire da un invi- 
to remoto di un nostro contatto online. In entram- 
bi i casi si verifica un evento ConversationCreated, 
il cui gestore riceverà come parametro un oggetto 
ConversationCreatedEventArgs. La proprietà Ini- 
tiator di quest'ultimo darà informazioni su chi ha 
effettuato la richiesta di iniziare una conversazio- 
ne, se in particolare esso è nuli, significa che la ri- 
chiesta proviene da un client remoto. 

void messenger_ConversationCreated( 

object sender, ConversationCreatedEventArgs e) 
{ if (e.Initiator == nuli) 

{ this.Invoke(new CreateConversationDelegate( 

CreateConversationForm), new object[] 
{ e.Conversation }); } 

_} 

private delegate ConversationForm 
CreateConversationDelegate(Conversation conversation); 
private ConversationForm CreateConversationForm( 

Conversation conversation) 
{ ConversationForm ConversationForm = new 

ConversationForm(conversation); 
ConversationForm. Handle.ToInt32(); 
return ConversationForm; 
} 

Notate che nel caso di una richiesta remota, la 
Form di conversazione viene creata, ma non mo- 
strata, fino all'arrivo di un messaggio, ed allora fac- 
ciamo solo in modo di creare l'handle della fine- 



stra da mostrare successivamente. Viceversa, se 
siamo noi a voler contattare un nostro contatto, 
cliccando sul relativo item di menu, il metodo in- 
vocato sarà il seguente, che crea e mostra la Form. 

void item_Click(object sender, EventArgs e) 
{ ToolStripMenuItem item = sender as 

ToolStripMenuItem; 

if (item != nuli && item.Tag is Contact) 

{ Contact selectedContact = item.Tag as Contact; 

if (messenger. Connected && selectedContact ! = 

nuli && selectedContact. Online == true) 

{ Conversation conversation = 

messenger.CreateConversation(); 
conversation. Invite(selectedContact); 
ConversationForm form = new 

ConversationForm(conversation); 
form.ShowQ; } 



} 



Dopo aver ricavato il contatto selezionato, viene 
creata una conversazione, ed inviato il relativo in- 
vito al contatto remoto. L'oggetto Conversation 
viene utilizzato per creare la form di conversazio- 
ne. Il codice completo della Form di conversazio- 
ne potete osservarlo prendendolo dal CD allegato, 
mostriamo però come inviare un messaggio al 
contatto: 



TextMessage message 



new TextMessage( 

txtlnput.Text); 



Conversation. Switchboard.SendTextMessage(message); 

mentre alla ricezione di un messaggio si verifiche- 
rà l'evento TextMessageReceived dal quale si può 
ricavare il nome del contatto ed il testo del mes- 
saggio: 

private void Switchboard_TextMessageReceived( 

object sender, TextMessageEventArgs e) 

{ //■■■ 

string contatto= e. Sender. Name; 
string messaggio= e.Message.Text; 
//mostra messaggio 



CONCLUSIONI 

Grazie alla libreria dotMSN abbiamo integrato in 
una applicazione .NET le funzionalità del servizio 
MSN Messenger. DotMSN fornisce in maniera sem- 
plice la possibilità di accedere al servizio MSN, di 
utilizzare ogni sua funzionalità come ricavare l'e- 
lenco dei contatti, spedire e ricevere messaggi, e 
così via, ed in più è una libreria free. 

Antonio Pelleriti 





COMTROL.IMVOKE 

Per eseguire un'opera- 
zione sull'interfaccia 
grafica, ad esempio im- 
postare il tsto di una 
Label, in un'applicazio- 
ne multithread, in alcu- 
ni casi è necessario uti- 
lizzare il metodo Con- 
trol. Involte. Il caso di cui 
parliamo è quando 
l'operazione è effettua- 
ta in un thread diverso 
ad esempio da quello 
in cui esegue la form 
che contiene il control- 
lo. È necessario dunque 
definire un delegate, 
quindi il metodo che 
imposta il testo, ed 
infine eseguire il meto- 
do Invoke, ad esempio 
così: 

Mia Form. Invoke(new 

MioDelegate( 

EnableMenuItemSafe), 

new object[] 

{argl,arg2}); 
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ALLA SCOPERTA 
DEL DATAGRIDVIEW 

IL .NET FRAMEWORK 2.0 HA INTRODOTTO IL CONTROLLO DATAGRIDVIEW PER 
LA PRESENTAZIONE DI DATI IN FORMA TABELLARE, UN NOTEVOLE PASSO AVANTI 
RISPETTO AL VECCHIO DATAGRID 




n 




REQUISITI 



9 Conoscenze medie 
1 diC# 



I 



.NET Framework 2.0, 
Microsoft Visual Studio 
.NET 2005 




Uno dei modi più comuni di presentare i dati 
in un'applicazione Windows è quello tabel- 
lare. Per intenderci il classico modo utiliz- 
zato da Excel, dove gli elementi sono rappresentati 
in una tabella composta da righe e colonne. Questa 
modalità di visualizzazione è molto usata all'interno 
delle applicazioni, e anche in quelle sviluppate da 
noi non mancherà certo la necessità di dover rap- 
presentare una qualche informazione visualizzan- 
dola sotto forma di tabella. Per agevolare il compito 
del programmatore nella presentazione di dati sotto 
questa forma. Il .NET Framework 1.0 e di seguito 
1' 1.1 mettevano a disposizione il controllo DataGrid, 
una classica griglia composta da righe e colonne. La 
DataGrid consentiva di selezionare, allargare e 
restringere righe e colonne, ma diventava complica- 
ta da gestire quando era necessario personalizzarla 
per i propri scopi, soprattutto in maniera program- 
matica. Questo è lo scenario che ha portato alla 
nascita di un controllo totalmente nuovo, chiamato 
DataGridView. 



IL CONTROLLO 
DATAGRIDVIEW 

Il controllo DataGridView fornisce numerosi meto- 
di, proprietà, ed eventi per personalizzare il suo 
aspetto ed il suo comportamento, sia a design rime, 
in modo visuale, da un IDE come Visual Studio, sia a 
runtime, in maniera programmatica. Spulciando 
nella documentazione si nota subito come siano 
state introdotte molte nuove caratteristiche rispetto 
al tradizionale DataGrid. La classe DataGridView 
permette di definire diverse tipologie di colonne, 
per diversi tipi di dati da trattare. Inoltre esse sono 
anche estensibili e personalizzabili in maniera più 
flessibile ed allo stesso tempo semplice di quanto 
fosse possibile con DataGrid. Mentre DataGrid era 
un controllo dedicato alla visualizzazione di ele- 
menti provenienti da una sorgente dati, ad esempio 
una tabella di un database, il controllo DataGrid- 
View permette di lavorare in maniera trasparente 
con oggetti eterogenei come ad esempio dati locali o 



collezioni di business object o entrambi in contem- 
poranea. Il controllo DataGridView permette molte 
operazioni per la configurazione dei singoli compo- 
nenti della griglia. Ad esempio è possibile nasconde- 
re righe, colonne, intestazioni, permette di bloccar- 
le per evitarne lo scrolling, consente la visualizzazio- 
ne di ToolTip e menu contestuali per ogni singola 
cella, riga o colonna, o ancora configurare i bordi, le 
dimensioni i colori. Una caratteristica presente 
invece nel vecchio controllo DataGrid e non più 
presente in DataGridView è la possibilità di visualiz- 
zare dati di due tabelle collegate fra loro, ad esempio 
immaginare una relazione fra clienti e ordini. Con le 
DataGridView è necessario usare due controlli diffe- 
renti per implementare una vista Master/Details. 



IL DESIGNER 

DI VISUAL STUDIO 

Una DataGridView è totalmente configurabile uti- 
lizzando il designer di Visual Studio 2005. È suffi- 
ciente creare una nuova Form e trascinare dalla 
Toolbox il controllo DataGridView sulla sua superfi- 
cie. Se l'applicazione contiene già una DataSource, 
essa può essere assegnata alla griglia per mezzo del 
suo^ Hcome visualizzato in Figura 1 . 



j 





DataGridView Tasks 

Choose Data Source 
Edit Columns... 
Add Column... 
EU Enable Adding 
EU Enable Editing 
EU Enable Deleting 

Enable Column Reordering 
Dock in parent container 




Fig. 1: Lo smart tag della DataGridView 

Un'altra possibilità, ancora più immediata, è quella 
di trascinare la DataSource, ad esempio una Data- 
Table, direttamente sulla form. Sempre per mezzo 
dello smart tag, è possibile accedere a diverse opzio- 
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ni per personalizzare l'aspetto della DataGridView. 
Ad esempio cliccando su Edit Columns o Add 
Column, è possibile aggiungere e personalizzare le 
colonne (Figura 2). 





5elected Columns: 




Bound Column Properties 

Bèi i 




[abìl Nome 
^ DataUscita 
[abìl NumeroRivista 


ContextMenuStrip 


(none) 


ReadOnly 


False 


Resizable 


True 


SortMode 


NotSortable 


E Data 


^h! 


DataPropertyName 


Copertina 


E Design 

(Name) 


copertinaDataGridVie'A'Iri'i.: 


ColumnType 


DataGridViewIrnaget diurni 


(Name) 

Indicate? the name used 
object, 


n code to identify the 




[ Add.,, ] [ Remove 




[ 


OK [ Cancel 





Fig. 2: Creazione delle colonne della DataGridView 

Naturalmente se il controllo viene associato ad una 
sorgente dati, le colonne saranno generate automa- 
ticamente, altrimenti è possibile aggiungerne a pia- 
cimento cliccando sul pulsante Add. 




PRIMI PASSI 

Partiremo con un esempio semplice, dove utilizzere- 
mo una List<Rivista> contenente i dati relativi alle 
uscite di ioProgrammo, comprensivi dell'immagine 
della copertina. Questi dati dovranno essere visua- 
lizzati in una DataGridView. Notate che faremo uso 
dei generics, anche essi introdotti nel framework 2.0. 
L'esempio è il seguente: 

Li st< Rivista > riviste = new List< Rivista >(); 
Rivista ri = new Rivista(); 
ri. Nome = "IoProgrammo"; 



ri. NumeroRivista = 92; 



ri. DataUscita = new DateTime(2005, 6, 1); 



ri. Copertina = img92; 



Rivista r2 = new RivistaQ; 



r2.Nome = "IoProgrammo"; 



r2. NumeroRivista = 93; 



r2. DataUscita = new DateTime(2005, 7, 1); 



r2. Copertina = img93; 



riviste. Add(rl); 



riviste. Add(r2); 



this.dataGridViewl.DataSource = riviste; 

Le righe della DataGridView apparirebbero troppo 
strette per contenere le immagini delle copertine 
intere, come da nostra intenzione. Utilizzeremo 
quindi la proprietà AutoSizeRowsMode impostan- 
dola al valore DataGridViewAutoSizeRowsMode.AU- 
Cells per autodimensionare sia le celle di intestazio- 
ne sia quelle contententi i dati: 

dataGridViewl. AutoSizeRowsMode = 

DataGridViewAutoSizeRowsMode.AIICells; 



■"liBÉl 

Ctt 



Fig. 3: Aggiungere nuove colonne 



Per visualizzare i dati sarà sufficiente impostare la 
proprietà DataSource della classe DataGridView. 
La classe DataGridView supporta il classico modello 
del data-binding per le Windows Forms. E cioè la 
sorgente dati può essere di un qualunque tipo che 
implementi una delle interfacce seguenti: 

• List, ad esempio le liste generiche List<T>, e in- 
clusi gli array mono dimensionali. 

• ListSource ad esempio oggetti DataTable e Da- 
taSet. 

• BindingList, per esempio la classe BindingList. 

• BindingListView ad esempio la classe Binding- 
Source. 

In genere si associa alla proprietà DataSource un 
componente BindingSource, il quale a sua volta vie- 
ne associato alla vera sorgente dati, oppure popola- 
ta con collezioni di business objects. Il componente 
BindingSource effettua automaticamente il binding 
ad una grande varietà di sorgenti e risove automati- 
camente diverse questioni relative al data binding. 



DATASOURCE E DATAGRIDVIEW 



È possibile aggiungere una 
DataGridView automatizzando 
la creazione di colonne e dei 
relativi tipi se si ha a 
disposizione una sorgente dati. 
Ad esempio, implementando 
una classe Rivista, possiamo 
cliccare sul menu Data-> Add 



New Data Source, selezionare 
quindi la classe Rivista, e 
vedremo apparire una nuova 
sorgente dati fra quelle 
disponibili. A questo punto 
basta trascinare la Data Source 
su una Form per creare la 
DataGridView relativa. 



* ^ X Rivista. cs Exarnplel.es* Start Page Formi, cs EKamplel.cs [Design]* Form l.cs [Desk 



{} BusinessObjects / j 
- J Rivista v \ l 

_J Copertina 

^ a DataUscita 

abi Nome 

abi Nurner 
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La nostra DataGridView, popolata di riviste con im- 
magini di copertina e date di uscita apparirà come 
in Figura 4: 



dataGridViewl.Columns.Add(coll); 




Fig. 4: Immagini in una DataGridView 



AGGIUNGERE 
RIGHE E COLONNE 

Il modo più comune di visualizzare i dati nella Data- 
GridView, passa dunque per l'uso del DataBinding, 
ciò avviene in particolare se la proprietà AutoGene- 
rateColumns è impostata a true, come lo è per de- 
fault, e congiuntamente le proprietà DataSource o 
DataMember vengono impostate o modificate. 
È però possibile adottare un approccio programma- 
tico per aggiungere, modificare e rimuovere righe e 
colonne. Le proprietà Rows e Columns rappresenta- 
no infatti le collezioni di DataGridViewRow e Data- 
GridViewColumn. In particolare la prima contiene 
una collection di DataGridViewCell, ricavabile dalla 
proprietà Cells. Il seguente esempio aggiunge due 
colonne, la prima di tipo DataGridViewTextBoxCo- 
lumn, con l'intestazione di colonna impostata me- 
diante la proprietà HeaderText. 

dataGridViewl. Columns. Clear(); 
DataGridViewTextBoxColumn coli = new 

DataGridViewTextBoxColumnO; 
co 11. HeaderText = "Text"; 

La seconda colonna viene creata invece a partire da 
una DataGridViewLinkCell, mediante un altro over- 
load del costruttore. 

DataGridViewLinkCell NnkCell = new 

DataGridViewLinkCellQ; 

DataGridViewColumn col2 = new 

DataGridViewColumn(linkCell); 
col2. HeaderText = "Link"; 

Per aggiungere le colonne alla DataGridView è suffi- 
ciente utilizzare il metodo Add della collection Co- 
lumns: 



dataGridViewl. Columns. Add(col2); 

Adesso possiamo aggiungere qualche riga, impo- 
stando ad esempio il testo contenuto nelle celle di 
tipo DataGridViewLinkCell: 

for (int i = 0; i < 5; i++) 

{ 

dataGridViewl. Rows. Add(); 
dataGridViewl. Rows[i].Cells[l].Value = 

"www.ioprogrammo.it"; 

y~ 

Ogni proprietà, dunque, permette di aggiungere, in- 
serire e rimuovere celle, righe e colonne mediante i 
classici metodi delle Collection, ad esempio Add, 
Insert, Remove. L'esempio seguente invece crea an- 
che una colonna con una ComboBox per scegliere il 
dato da un elenco discesa. In questo caso la Data- 
GridViewComboBoxColumn viene popolata con il 
nome dei mesi dell'anno, e da questa viene poi crea- 
ta ed aggiunta una nuova riga alla DataGridView. 

DataGridViewComboBoxColumn comboColumn = new 
DataGridViewComboBoxColumn(); 
DataGridViewTextBoxColumn textColumn = new 

DataGridViewTextBoxColumnO; 
dataGridViewl. Columns. Add(comboColumn); 
dataGridViewl. Columns. Add(textColumn); 
DataGridViewRow row = new DataGridViewRow(); 
DataGridViewComboBoxCell comboCell = new 

DataGridViewComboBoxCellO; 
for (int i = 1; i < 13; i++) 
{ 

comboCell. Items.Add(new DateTime(2000, i, 1 
).ToString("MMMM")); 

> 

comboCell. Value = comboCell. Items[0].ToString(); 

row. Cells. Add(comboCell); 

row. Cells. Add(new DataGridViewTextBoxCell()); 

dataGridViewl. Rows. Add(row); 



In Figura 5 viene mostrata una DataGriView con la 
colonna Combo appena creata. 




febbraio 

marzo 

aprile 

maggio 

giugno 

luglio 

agosto 




Fig. 5: Colonne con ComboBox 
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TIPI DI COLONNE 

La DataGridView utilizza diversi tipi di colonne 
per mostrare le sue informazioni, e consentirne la 
modifica. 

Come già visto, la proprietà AutoGenerateColumn 
impostata a true consente di creare automatica- 
mente i tipi appropriati ai dati contenuti nella sor- 
gente dati associata. 

Qui di seguito riassumiamo i diversi tipi di colon- 
ne utilizzabili per i nostri dati, ognuno dei quali è 
una classe derivata dalla classe DataGridViewCo- 
lumn. 

• IDataGridViewTextBoxColumn: utilizzata per 
rappresentare valori visibili come testo, dunque 
in genere numeri e stringhe. 

• IDataGridViewCheckBoxColumn: usata con i 
tipi bool e CheckState. 

• IDataGridViewImageColumn: in genere viene 
associata ad oggetti Image oppure Icori. 

• IDataGridViewComboBoxColumn: quando si 
vogliono selezionare dei valori da una Combo- 
Box per inserirli in una riga. Non viene automa- 
ticamente associata alla DataSource ma bisogna 
generarle e popolarle manualmente. 

• IDataGridViewLinkColumn: permette di mo- 
strare dei link ipertestuali all'interno delle celle, 
ed anche questa viene associata manualmente 
ai dati contenuti nella griglia. 

• IDataGridViewButtonColumn: se si ha bisogno 
di una colonna con un pulsante mediante il qua- 
le eseguire comandi od altre operazioni. 

La Figura 6 mostra un esempio di DataGridView 
con tutti i tipi di colonne appena elencati, creata 
semplicemente con il designer di Visual Studio 2005 
e senza scrivere una sola riga di codice. 




Fig. 6: Tutti i tipi di colonne standard 



pò di tipo DoteTime. Per rappresentare questo tipo 
di dato le soluzioni possibili sono almeno due. La 
prima è quella di costringere l'utente ad inserire la 
data in un certo formato prestabilito, ma pur sempre 
come string, con tutti i possibili errori di digitazioni 
volontari o involontari. La seconda soluzione, che 
utilizzeremo in questo caso, è quella di implementa- 
re una colonna che permetta di scegliere una data 
dal classico controllo DateTimePicker 
Partiamo dal mostrare l'architettura che dovrà ri- 
spettare la nostra colonna in termini di classi neces- 
sarie e delle loro interdipendenze. 
Innanzitutto è necessario derivare una nuova classe 
da DataGridViewColumn, che rappresenterà la co- 
lonna vera e propria. Una seconda classe dovrà deri- 
vare da DataGridViewCell, per rappresentare ognu- 
na delle celle visualizzate per ogni riga della colon- 
na. Infine è necessario implementare una classe che 
derivi da Control o dalla classe del controllo che do- 
vrà ospitare, e che implementerà l'interfaccia stan- 
dard IDataGridViewEditingControl 
La Figura 7 mostra il diagramma delle classi fra le 
quali potete notare le nostre tre nuove DateTime- 
PickerColumn, DateTimePickerCell e DateTimePic- 
kerEditingControl 
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Fig. 7: Il diagramma delle classi per la colonna custom 

Chiameremo DateTimePickerColumn la classe che 
estenderà la DataGridViewColumn. L'implementa- 
zione è la seguente 



COLONNE 
PERSONALIZZATE 

Una fra le caratteristiche più apprezzate della nuova 
DataGridView e quella relativa alla creazione di tipi 
di colonne personalizzati, se quelli standard non 
fossero sufficienti, e tutto ciò con la possibilità di 
ospitare all'interno di una cella un qualsiasi control- 
lo, nuovamente standard o anch'esso personalizza- 
to. Supponiamo di voler permettere all'utente di in- 
serire in una riga della DataGridView un nuovo re- 
cord fra i cui campi è previsto un valore DoteTime. 
Nel primo esempio abbiamo già utilizzato un cam- 



public class DateTimePickerColumn : 

DataGridViewColumn 

{ 

public DateTimePickerColumn() : base(new 

DateTimePickerCellO) 
{ 



} 



public override DataGridViewCell CellTemplate 



{ 



get 
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return base.CellTemplate; 
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} 



set 



if (value != nuli && !value.GetType() 
.IsAssignableFrom(typeof(DateTimePickerCell))) 



{ 



throw new InvalidCastException( 

"La cella deve essere di tipo 
DateTimePickerCell"); 



public override 


object DefauItNewRowValue 


{ 


get 


{ 


return DateTime.Now; 


} 


} 


} 



> 



base.CellTemplate = value; 



} 



La classe che invece dovrà mostrare le celle, deriverà 
da DataGridViwTextBoxCell Un'implemenrazione 
che effettua F override della proprietà CellTemplate, 
in maniera da essere sicuri che esse siano di tipo Da- 
teTimePickerCell, è la seguente 

public class DateTimePickerCell : 

DataGridViewTextBoxCell 
{ 

public DateTimePickerCell() : base() 
{ 

this.Style. Format = "dd/MMM/yyyy"; 
} 

public override void InitializeEditingControl(int 

rowlndex, object 
initialFormattedValue, DataGridViewCellStyle 
dataGridViewCellStyle) 

{ 

base.InitializeEditingControl(rowIndex, 

initialFormattedValue, dataGridViewCellStyle); 
DateTimePickerEditingControl ctl = 

DataGridView. EditingControl as 
DateTimePickerEditingControl; 
ctl. Value = (DateTime)this. Value; 



Essa definisce il formato da utilizzare per rappresen- 
tare la data, il tipo di dati che conterrà la cella, e cioè 
DateTime, il valore di default assegnato alla creazio- 
ne di una nuova riga. Notate come nel metodo Ini- 
tializeEditingControl e nella proprietà EditType, 
venga definito il tipo del controllo utilizzato come 
editor dei valori DateTime ovvero la classe DateTi- 
mePickerEditingControl 
Un'implementazione di questa classe è la seguente: 

class DateTimePickerEditingControl : DateTimePicker, 
IDataGridViewEditingControl 



{ 



private DataGridView theDataGridView; 
private bool valueChanged = false; 



private int rowlndex; 



public DateTimePickerEditingControl() 



{ 



this. Format = DateTimePickerFormat. Short; 



public object EditingControlFormattedValue 



{ 



get 



return this. Value. ToShortDateStringQ; 



set 



String newValue = value as String; 



if (newValue != nuli) 



{ 



this. Value = DateTime. Parse(newValue); 



public override Type EditType 
{ 
get 



return typeof(DateTimePickerEditingControl); 



public object GetEditingControlFormattedValue( 
DataGridViewDataErrorContexts context) 



} 

public override Type ValueType 
{ ~ 

get 



return typeof(DateTime); 



return EditingControlFormattedValue; 
} 

public void ApplyCellStyleToEditingControl( 
DataGridViewCellStyle dataGridViewCellStyle) 

{ 

this. Font = dataGridViewCellStyle. Font; 
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public int EditingControlRowIndex 



{ 



get 



return rowlndex; 



set 



valueChanged = value; 



public Cursor EditingPanelCursor 



{ 



get 




rowlndex = value; 



return base. Cursor; 



> 



public bool EditingControlWantsInputKey( 

Keys key, bool dataGridViewWantsInputKey) 



switch (key & Keys.KeyCode) 

{ 

case Keys. Return: 

return true; 
default: 

return false; 



protected override void OnValueChanged( 

EventArgs eventargs) 
{ 

valueChanged = true; 
this.EditingControlDataGridView 

.NotifyCurrentCellDirty(true); 
base.OnValueChanged(eventargs); 



} 



> 



public void PrepareEditingControlForEdit(bool 
selectAII) 

{ 
_} 

public bool 

RepositionEditingControlOnValueChange 
{ 
get 
{ 

return false; 



public DataGridView EditingControlDataGridView 

{ 
get 



return theDataGridView; 



set 



Nel costruttore viene definito il formato utilizzato 
dal DateTimePicker per le date, mentre la proprietà 
EditingControlFormattedValue permette di ottenere 
o impostare il valore DateTime da visualizzare. 
Compilato il progetto, provate a creare una nuova 
DataGridView, o ad aggiungere mediante l'editor 
una nuova colonna ad una esistente. Fra quelle di- 
sponibili, ci sarà la colonna appena implementata, e 
che a runtime vi permetterà di selezionare una data 
come in Figura 8. 
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Fig. 8: La colonna DateTimePicker 



theDataGridView = value; 



public bool EditingControlValueChanged 



{ 



get 



return valueChanged; 



set 



CONCLUSIONI 

Abbiamo visto come utilizzare il nuovo controllo 
DataGridView, visualizzando dati da una sorgente 
dati, oppure definendo righe, colonne e dati anche 
programmaticamente. Inoltre la DataGridView, ci ha 
permesso, estendendo classi e implementando in- 
terfacce, la realizzazione di un tipo di colonna total- 
mente personalizzato. 

Antonio Pelleriti 
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PERSISTENZA IN JAVA2 
MICRO EDITION 

PREGI E DIFETTI DEL RECORD MANAGEMENT SYSTEM, IL SISTEMA STANDARD 

PER LA GESTIONE DELLA PERSISTENZA DATI SULLA PIATTAFORMA J2ME. REALIZZIAMO 

UNA SEMPLICE MIDLET PER LA GESTIONE DI UNA VIDEOTECA PERSONALE 
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La gestione della persistenza dei dati è senza 
dubbio un argomento ricorrente durante lo 
sviluppo di qualsiasi progetto. Le problemati- 
che cambiano in rapporto alla tipologia di applica- 
zione che si sta sviluppando. Un'applicazione per il 
desktop necessita di attenzioni diverse da una per il 
Web e, a maggior ragione, un'applicazione per il 
mondo Mobile è interessata da problemi di persi- 
stenza dei dati molto specifici legati all'architettura 
dei sistemi. Per questa tipologia di applicativi, Java 
mette a disposizione del programmatore una serie 
di metodologie la cui scelta dipende dalla tipologia 
dei dati che si devono trattare e dalle operazioni con 
le quali questi dati devono essere manipolati. 
Attraverso la tecnologia J2ME, è possibile leggere 
dati esterni accedendo allo stream di un file di risor- 
sa presente nel pacchetto jar che contiene l'applica- 
zione stessa. Come si può ben capire, questa tecni- 
ca non consente l'inserimento di dati dall'esterno a 
tempo di esecuzione. Per risolvere questo problema 
lo strato MIDP (Mobile Information Device Profile) 
ci viene incontro mettendoci a disposizione il Re- 
cord Management System (RMS): una semplice ba- 
se dati record- oriented. L'entità "record" è proprio il 
punto cruciale di questo sistema. Il tutto è contenu- 
to nel package javax.microedition.rms composto da 
una serie di interfacce ed eccezioni, su cui ci soffer- 
meremo nel prosieguo dell'articolo, ed una sola 
classe concreta: RecordStore. Le istanze di tale clas- 
se rappresentano degli elementi di persistenza in 
cui è possibile memorizzare e recuperare i dati. 



UN'APPLICAZIONE 
D'ESEMPIO 

In questo articolo realizzeremo una semplice appli- 
cazione di esempio che usa il sottosistema RMS per 
la gestione della nostra videoteca personale. 
Tale applicazione, che battezziamo con il nome 
VideoStore, dovrà mettere a disposizione dell'uten- 
te finale le seguenti funzionalità: 

1) memorizzazione di un nuovo elemento 
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Fig.l: Schermata d'avvio sul Wireless Toolkit 
Emulator 

2) rimozione di un elemento presente nella video- 
teca 

3) aggiornamento di un elemento precedente me- 
morizzato 

4) elenco di tutti gli elementi presenti nella video- 
teca 

5) ricerca di un elemento presente nella videoteca 
in base ad una data chiave. 

In Figura 2 è illustrato il flusso logico della MIDlet 
in questione. Questo diagramma, che evidenzia la 
struttura grafica ed i comportamenti che l'applica- 
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Fig.2: Struttura della MIDlet per la gestione 
della videoteca personale 
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zione dovrà avere a fronte di determinati comandi, è 
stato creato con il FlowDesigner presente nel Mobi- 
lity Pack di Netbeans. Con l'aiuto di quest'ultimo è 
stata implementata la parte di GUI (Graphical User 
Interface) dell'esempio, contenuta nella classe it.io- 
programmo.videostore.gui. Non ci soffermeremo 
oltre su questo aspetto in quanto va al di fuori dello 
scopo del presente articolo. Come prima cosa si 
deve definire la classe rappresentante i singoli ele- 
menti video, che chiameremo Videoltem. 

package it.ioprogrammo.videostore.data; 
public class Videoltem { 
private int id; 



private String title; 



private String author; 



private int year; 



private String notes; 



public VideoItemQ { } 



public int getldQ { 



return this.id;} 



public void setld(int id) { 



this.id = id;} 



public String getTitleQ { 



return this. title;} 



public void setTitle(String title) { 



this. title = title;} 



public String getAuthorQ { 



return author;} 



public void setAuthor(String author) { 



this. author = author;} 



public int getYearQ { 



return year;} 



public void setYear(int year) { 



this. year = year;} 



public String getNotesQ { 



return notes;} 



public void setNotes(String notes) { 



this. notes = notes;} 



> 



Come possiamo notare, si tratta di una semplice 
classe conforme alle specifiche javabean che ci per- 
mette di gestire, attraverso i metodi setter e getter, le 
proprietà di un elemento video. 



RECORDSTORE: 
INIZIALIZZAZIONE 
E APERTURA 

Per separare la parte grafica da quella dati e rendere 
il codice più elegante concentreremo la gestione 
della persistenza nella classe it.ioprogrammo. video - 
store.data.DataManager. Per gestire gli elementi di 
tipo Videoltem useremo un unico oggetto Record- 
Store. Quest'ultimo viene spesso paragonato, con le 
dovute limitazioni, ad una tabella di un database. 



Così come avviene per le tabelle, il nostro contenito- 
re dovrà essere inizializzato prima che sia possibile 
utilizzarlo. L'invocazione del metodo statico open- 
RecordStore riceve due parametri: il nome del re- 
cord ed un boolean che, posto a true inizializza il 
contenitore se necessario. 

/* Contenitore dati RMS */ 

private RecordStore videoStore; 

/* Costruttore interno per l'implementazione del 

pattern singleton */ 
private DataManagerQ { 



try { 



// apre il RecordStore se esiste, altrimenti 

ne crea uno nuovo 
videoStore = RecordStore. openRecordStore( 

"STORE", true); 

} catch (RecordStoreException ex) { 



ex. printStackTraceQ ; } 



} 



È importante evidenziare che, l'invocazione del me- 
todo appena descritto associa il RecordStore alla 
MIDlet suite che lo crea. Pertanto, due MIDlet suite 
che inizializzino due RecordStore con lo stesso 
nome gestiranno due contenitori di persistenza di- 
stinti e separati. È inoltre possibile recuperare i nomi 
di tutti i RecordStore associati ad una MIDlet suite 
richiamando il metodo statico HstRecordStores. 



CREATE, READ, UPDATE 
& DELETE 

Adesso ci addentreremo nel cuore della nostra ap- 
plicazione implementando le funzionalità base, co- 
munemente identificate dall'acronimo CRUD: 
Create, Remove, Update e Delete di un oggetto di 
classe Videoltem. Prima di passare al codice è utile 
capire come i RecordStore gestiscono i dati al loro 
interno. Come affermato in precedenza questo mec- 
canismo di persistenza è in grado di memorizzare 
delle entità che chiameremo record. Ogni record è 
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Fig.3: Form per aggiungere, visualizzare ed aggiorna- 
re un elemento video 
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composto da un array di byte identificato, all'inter- 
no del RecordStore, da un ID numerico positivo. 
Quest'ultimo può anche essere equiparato ad una 
primary-key o al ROWID utilizzato da Oracle per 
identificare ogni singolo record all'interno di una 
tabella. L'invocazione del seguente metodo gestisce 
le operazioni di aggiunta e aggiornamento del Vi- 
deoltem passato come argomento. In base al valore 
della variabile intera id, contenuta nell'oggetto Vi- 
deoltem, il metodo stabilisce se eseguire un nuovo 
inserimento oppure l'aggiornamento di un elemen- 
to esistente. 

public void saveVideo(VideoItem video) { 
ByteArrayOutputStream baos = new 

ByteArrayOutputStreamO; 
DataOutputStream dos = new 

DataOutputStream(baos); 
this.write(video.getTitle(), dos); 
this.write(video.getAuthor(), dos); 
this.write(""+video.getYear(), dos); 



this.write(video.getl\lotes(), dos); 



byte[] record = baos.toByteArray(); 
if (video. getld() <= 0) { // id <= 0, aggiunge 
un nuovo record ... 



try { 



this.videoStore.addRecord(record, 0, 

record. length); 
} catch (Record Sto re Exception ex) { 



ex.printStackTraceQ; } 



} else {//... record esistente: azione di update 



try { 



this.videoStore.setRecord(video.getId(), 
record, 0, record. length); 
} catch (RecordStoreException ex) { 



ex. printStackTraceQ ; } 



}} 



/* scrive la stringa di testo sullo stream di output 

specificato */ 
private void write(String text, DataOutputStream 

dos){ 



text = text == nuli ? "" : text; 



try { 



dos. writeUTF(text) ; 



} catch (IOException ex) { 



ex.printStackTraceQ;} 



} 



Per semplificare la fase di scrittura dell'oggetto Vi- 
deoltem, è stato utilizzato un oggetto di tipo Data- 
OutputStream che fa da wrapper ad un ByteArray- 
OutputStream. Analogamente, il processo di lettura 
di un Videoltem sarà gestito attraverso un ByteAr- 
raylnputStream contenuto all'interno di un Dataln- 
putStream. 

private Videoltem getVideoById(int id) { 
Videoltem video = new VideoItemQ; 



// crea un DatalnputStream partendo dall'array 

di byte ... 
DatalnputStream dis = nuli; 

try { 

dis = new DataInputStream(new 

ByteArrayInputStream( 
this.videoStore.getRecord(id))); 
} catch (RecordStoreException ex) { 

ex.printStackTrace();> 
// ... e legge le proprietà del video 
video. setld(id); 
video.setTitle(this.read(dis)); 
video.setAuthor(this.read(dis)); 
video.setYear(Integer.parseInt(this.read(dis))); 
video.setNotes(this.read(dis)); 
return video;} 
/* legge la stringa in formato UTF dallo stream 

specificato */ 
private String read(DataInputStream dis) { 
String value = nuli; 

try { 

value = dis.readUTF(); 
} catch (IOException ex) { 

return nuli;} 
value = value. equals("") ? nuli : value; 
return value; 



Così come la fase di lettura, anche quella di elimina- 
zione si basa sulla conoscenza dell'identificativo del 
record su cui si vuole andare ad operare. Il seguente 
stralcio di codice illustra come rimuovere un record 
dal RecordStore. 

public void deleteVideo(int videold) { 

try { 

this.videoStore.deleteRecord(videoId); 
} catch (InvalidRecordIDException ex) { 

System. err.println("Identificativo " + videold 
+ " non valido!"); 
} catch (RecordStoreNotOpenException ex) { 

System. err.println("VideoStore non aperto"); 
} catch (RecordStoreException ex) { 
System. err.println("Errore durante 

l'eliminazione del record"); } 
} 



L'identificativo del record rimosso non verrà più uti- 
lizzato durante il rimanente ciclo di vita del Record- 
Store. 



SORT & SEARCH 

Realizzeremo due nuove features: visualizzazione 
dell'intero catalogo video e ricerca di uno o più ele- 
menti video in base ad una chiave immessa dall'u- 
tente. Entrambe le funzionalità dovranno presenta- 
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re i risultati ordinati in base al titolo del video. Per 
semplificare la fase di ordinamento basterà imple- 
mentare l'interfaccia RecordComparator. 

class VideoItemComparator implements 

RecordComparator { 
/* stream di lettura */ 
private DatalnputStream dis; 
/** Interface method implementation */ 
public int compare(byte[] b, byte[] bO) { 
// legge i titoli 
int vai = this.getTitle(b).compareTo( 

this.getTitle(bO)); 



if (vai < 0) { 



vai = RecordComparator. PRECEDES; 



} else if (vai > 0) { 



vai = RecordComparator. FOLLOWS; 



} else { 



vai = RecordComparator. EQUIVALENT;} 



return vai; } 



/* legge il titolo del video descritto dallo 

specifico array di byte */ 
private String getTitle(byte[] ree) { 
dis = new DataInputStream(new 

ByteArraylnputStream(rec)); 



String title = nuli 



try{ 



title = dis.readUTF().tol_owerCase(); 



} catch (IOException ex) { 



ex.printStackTraceQ;} 



return title; } 



} 



Il "cuore" di questa classe è rappresentato dal meto- 
do compare che riceve come parametri due byte ar- 
ray, ognuno dei quali rappresenta un record. Il com- 
pito di questo metodo è quello di determinare l'or- 
dine di precedenza tra i due record specificati. Il va- 
lore intero di ritorno deve essere una delle costanti 
esposte dalla stessa interfaccia: EQUIVALENT, PRE- 
CEDES e FOLLOWS. Anche il criterio di ricerca è rea- 
lizzabile attraverso l'uso di un'altra interfaccia espo- 
sta dal sistema RMS: RecordFilter. 

class VideoItemFilter implements RecordFilter { 
/* chiave di ricerca */ 
private String matcher; 
/* stream di lettura */ 
private DatalnputStream dis; 
/** 

* Crea un nuovo filtro con una determinata 

chiave di ricerca 

* 

* @param matcher chiave di ricerca da 

associare al filtro 

*/ 

public VideoItemFilter(String matcher) { 
this. matcher = matcher.toLowerCase();> 



/* Interface method implementation */ 
public boolean matches(byte[] b) { 
dis = new DataInputStream(new 

ByteArraylnputStream(b)); 
String title = nuli; 

try{ 

title = dis.readUTF().toLowerCase(); 
} catch (IOException ex) { 
ex. printStackTrace() ; 
return false; } 



return title. indexOf(matcher) >= 0;} 



} 



Il metodo matches riceve un array di byte rappre- 
sentante il contenuto di un record e ritorna true se la 
chiave di ricerca inserita è un subset (case insensiti- 
ve) del titolo del record stesso. A questo punto non ci 
rimane che utilizzare le classi appena create invo- 
cando il metodo enumerateRecords di RecordStore di 
cui riportiamo la dichiarazione: 

public Record Enumeration enumerateRecords( 

RecordFilter filter, RecordComparator comparator, 
boolean keepUpdated) 
throws RecordStoreNotOpenException 

Il valore di ritorno rappresenta una struttura, bidire- 
zionalmente navigabile, che gestisce una sequenza 
logica di record in base ai parametri specificati. Po- 
tremmo quindi implementare la funzione di ordina- 
mento dell'intero catalogo video invocando il meto- 
do nel seguente modo: 

RecordEnumeration en = 

videoStore.enumerateRecords(null, 
new VideoItemComparatorO, false)); 

mentre per la fase di ricerca si dovrà aggiungere 
l'impementazione del RecordFilter costruita sulla 
chiave di ricerca inserita dall'utente: 

RecordEnumeration en = videoStore.enumerateRecords( 
new VideoItemFilter(key), new 
VideoItemComparatorO, false)); 



CONCLUSIONI 

In questo articolo abbiamo visto come, attraverso le 
API fornite dal sistema RMS, sia possibile memoriz- 
zare dati in maniera non volatile su un dispositivo 
mobile. Questa soluzione rappresenta la scelta più 
adeguata e portabile quando si vuole dare all'utente 
la possibilità di memorizzare e recuperare dati ine- 
renti la logica dell'applicazione, come nell'esempio 
descritto, o quando si vogliono rendere persistenti 
gli stati di configurazione della MIDlet suite. 

Fabrizio Fortino 




RECORDSTORE 
CONDIVISI 

Una delle caratteristi- 
che più interessanti 
introdotte con la ver- 
sione 2.0 del MID Pro- 
file è sicuramente la 
possibilità di condivide- 
re i RecordStore con le 
altre MIDlet suite in- 
stallate sul dispositivo. 
Questa funzionalità ri- 
sulta essere molto im- 
portante quando si svi- 
luppano MIDlet suite 
differenti a cui si vuole 
dare la possibilità di 
"comunicare" tra di lo- 
ro. Per far sì che un de- 
terminato RecordStore 
sia condivisibile è ne- 
cessario che la MIDlet 
suite, proprietaria della 
base dati, imposti la 
modalità di accesso (at- 
traverso il metodo set- 
Mode) ad AUTHMODE_ 
ANY. Un'altra applica- 
zione che vorrà accede- 
re a questa base dati 
condivisa dovrà dichia- 
rarlo esplicitamente 
utilizzando un'overload 
del metodo open Re- 
cordStore con i seguen- 
ti parametri: nome del 
RecordStore, nome del 
vendor e nome della 
MIDlet suite associata 
alla base dati. 
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JMX CONTROLLA I 
TUOI PROGRAMMI 

ILLUSTREREMO UNA TECNICA CHE CONSENTE A UN QUALUNQUE CLIENT DI INTERROGARE 
UN SOFTWARE IN ESECUZIONE ALLO SCOPO DI CONOSCERNE LO STATO DI FUNZIONAMENTO 
O ALTRI PARAMETRI 



Che cosa è JMX? In un primo momento la ri- 
sposta che daremo sembrerà decisamente 
"astratta". Vi proponiamo due definizioni: la 
prima ricavata da wikipedia: JMX: Java Manage- 
ment Extension è un'insieme di specifiche, pattern 
che permettono di inserire all'interno di una applica- 
zione sviluppata in "java dei componenti per il 
monitoraggio della stessa, chiamate Mbean". Una 
seconda ricavata dal sito di Sun "JMX (Java 
Management eXtensions), fornisce un metodo sem- 
plice e standard per gestire risorse applicativi dispo- 
sitivi". Cerchiamo dunque di chiarirci le idee, ten- 
tando di associare a queste due definizioni abba- 
stanza "fumose" un esempio pratico che ci consenta 
di traslare da un piano strettamente teorico a un 
piano decisamene più pratico. L'idea è la seguente: 
abbiamo costruito un'applicazione Web al cui inter- 
no esiste un modulo per la registrazione degli uten- 
ti. Ma quanti utenti abbiamo registrato? quanti 
utenti hanno tentato una registrazione e poi hanno 
abbandonato prima della fine? Quali referrer hanno 
portato gli utenti a registrarsi sul nostro sito? Se 
volessimo implementare una soluzione per dare 
risposta a questo tipo di problemi, potremmo sem- 
plicemente creare delle interfacce specifiche che 
una nostra applicazione potrebbe interrogare, per 
avere delle risposte immediate. È esattamente quel- 
lo che faremo tramite JMX. Perché JMX si differenzia 
dunque rispetto a questo tipo di soluzione? Per il 
semplice motivo che JMX è un insieme di specifiche 
per il disegno di interfacce che consentano di moni- 
torare/gestire il comportamento di un'applicazione. 
Saremo noi a stabilire quali sono le risorse da moni- 
torare/gestire "incastrandole" in un contenitore che 
chiameremo Mbean. Ogni Mbean dovrà rispettare 
delle specifiche particolari per essere compatibile 
con JMX. Al solito il vantaggio della tecnologia è 
quella di essere uno standard, per cui siamo sicuri 
che qualunque applicazione che utilizzi JMX sarà in 
grado di essere interrogata tramite un client che uti- 
lizzi il medesimo insieme di specifiche. Nel set di li- 
brerie di Java 1.5 è compresa anche "jconsole", un 
applicazione che mediante una GUI essenziale ma 
di immediato utilizzo permette di collegarsi e gesti- 
re qualsiasi applicazione JMX. Dopo questa introdu- 



zione, necessariamente lunga, andiamo ad iniziare. 



ARCHITETTURA DI JMX 

Come già detto al centro di JMX ci sono gli MBean, 
classi Java che rispettano gli standard JavaBean per il 
naming. Ad esempio una proprietà "xxx" di tipo int 
in lettura e scrittura dovrà essere implementata se- 
condo i due metodi: 

void setXxx(int val){ 

[»J_} 

int getXxx(){ 

[-] > 

Volendo invece pubblicare la proprietà "yyy" di tipo 
String in sola lettura il bean dovrà implementare il 
solo metodo 

String setYyy(){...} 

Gli MBean hanno il compito di esporre le proprietà 
e i metodi che hanno una rilevanza per l'applicazio- 
ne dal punto di vista della sua gestione. In sostanza 
all'interno del nostro MBean dovremo implementa- 
re tutte quelle strutture che vogliamo monitorare o 
gestire. Un MBean è definito da un'interfaccia e da 
una classe che la implementa. I metodi e le pro- 
prietà esposti sono quelli definiti nell'interfaccia. 
Il nome dell'interfaccia deve obbligatoriamente ter- 



JConsole: Connect lo Àgent 



( Locai \ Remote \ Advanced 



HostorIP: localhost 



Port: | 8090 
UserName: | 
Password: 



Connect 


Cancel 



Fig. 1: La finestra di connessione di "jconsole" nella 
quale digitate l'indirizzo al quale risponde l' MBean 
Server 




n 




REQUISITI 



7 Basi di Java 



I 



J2SE5.0 






Tempo di realizzazione 



http://www.ioprogrammo.it 



Giugno 2006/ 59 ► 



SISTEMA T I Monitor di applicazioni 





I TUOI APPUNTI 



minare per "MBean". È necessario poi scrivere l'im- 
plementazione di tale interfaccia. In questo caso 
non ci sono vincoli sul naming. Un'istanza del bean 
deve poi essere registrata presso un "MBean server" 
assegnandogli contestualmente un nome univoco. 
Il client JMX si collegherà proprio a tale MBean ser- 
ver per ottenere un riferimento agli MBean ivi pub- 
blicati. 



L'APPLICAZIONE 
DI ESEMPIO 

Come già detto, la nostra applicazione dovrà sem- 
plicemente gestire un gruppo di utenti registrati, da 
un lato non consentendo la registrazione oltre un 
certo numero, dall'altro implementando un metodo 
per ricercare un utente tramite il suo username. Una 
Map memorizzerà tutti gli utenti registrati usando 
come chiave l'username stesso. In questo modo la 
ricerca di username eventualmente già utilizzati e la 
ricerca di un utente a partire dall'username sarà 
molto rapida. La classe implementa l'interfacia 
Runnable, in modo da poter essere attivata in un 
thread separato. Come noto in questi casi il metodo 
runO, specificato nell'interfaccia Runnable, viene 
eseguito quando attraverso la classe Thread si crea 
un nuovo flusso di esecuzione. Il primo e l'ultimo 
metodo invocati da run() saranno startupO e shut- 
downO, richiamati rispettivamente nel momento in 
cui la nostra applicazione server per la gestione degli 
utenti parte e nel momento in cui viene disattivata. 
Il ciclo principale nel metodo runO fa si che l'appli- 
cazione non termini sino a quando l'attributo run- 
ning non sia valorizzato a false. Degli altri metodi 
riportiamo solo la signature: maxUserAllowedO for- 
nisce il massimo numero di utenti gestibili dal siste- 
ma, getUpTimeO la data in cui il sistema è stato atti- 
vato, i metodi addUserQ, removeUserQ e flndUser- 
ByUsernameO permettono rispettivamente di ag- 
giungere un utente, rimuoverne uno registrato e tro- 
varne uno dallo username. 

package ioprogrammo. server; 
public final class Server implements Runnable { 
private int maxUserAllowed; 
/** while true the server is up and running */ 
private boolean running = true; 
private final Date bootTime = new Date(); 
private Map<String, User> users; 
private Server() { 

reset();} 
public void reset() { 

users = new HashMap<String, User>(); 

maxUserAllowed = 

DEFAULT_MAX_USER_ALLOWED;> 

public int getMaxUserAllowedO {[...]} 
public void setMaxUserAllowed(int 



maxUserAllowed) {[...]} 



public int getNumberOfRegisteredUser() { 

return users. size();> 
public Date getUpTime() {return bootTime;} 
public void addUser(String username, String 

password) throws ServerException {[...]} 
public void removeUser(User user) {[...]} 
public User findUserByUsername(String username) 

{[■■■]} 

public void run() { 
startupO; 
while (running) { 

try { 

Thread. sleep(lOOO); 
} catch (InterruptedException e) { 
e.printStackTrace(); } } 
shutdown(); } 
private void startupO {[...]} 
private void shutdown() {[...]} 
public void halt() { 

running = false; } 
public static void main(String[] a) { 
new Thread(new Server()).start(); } 



INTERFACCIA 
DEL MBEAN 

Il primo MBean che realizzeremo permetterà di of- 
frire dati statistici sugli utenti registrati e sull'appli- 
cazione in generale. Si desidera conoscere il numero 
massimo di utenti ammessi, il numero di utenti 
effettivi, la data in cui il sistema è stato avviato, da 
quanto tempo il server è attivo e una media che dia 
il numero di utenti registrati per ora. Definiamo 
quindi un'interfaccia dal nome StatisticsMBean con 
gli opportuni metodi. Ricordate che JMX impone 
che ogni MBean implementi un'interfaccia il cui 
nome termini per "MBean". I metodi e le coppie set- 
ter/getter definiti nell'interfaccia saranno gli unici 
accessibili da remoto. C'è anche da ricordare che 
nell'interfaccia non è possibile utilizzare qualsiasi 
tipo di dato come parametro o tipo di dato restituito 
ma è meglio limitarsi ai tipi primitivi e ai rispettivi 
wrapper. Nei prossimi articoli avremo modo di ap- 
profondire questa questione. Per ora popoliamo la 
nostra interfaccia con soli getter che forniscono le 
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Fig. 2: Ecco la schermata che dovrebbe presentare 
jconsole per la visualizzazione del MBean che pubbli- 
ca dati statistici sull'applicazione 
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informazioni desiderate. 

package ioprogrammo. server. management; 

import java. util. Date; 

public interface StatisticsMBean { 

public int getMaxUserAllowedO; 

public int getNumberOfRegisteredUser(); 

public Date getBootTime(); 

public long getUpTime(); 

public doublé getRegisteredllserPerHour(); 



IMPLEMENTAZIONE 
DEL MBEAN 

JMX prevede che ogni interfaccia MBean, abbia 
un'implementazione. La strada più semplice 
sarebbe quella di scrivere semplicemente un'im- 
plementazione dei metodi sopra definiti. Per 
comodità, invece, definiamo prima di tutto una 
classe SuperMBean che subclasseremo per ogni 
MBean di cui avremo necessità. Seguiamo que- 
sta strategia perché come vedremo tutti gli 
MBean che utilizzeremo avranno dei metodi in 
comune. Ad esempio, come spiegato nell'intro- 
duzione, ad ogni MBean deve essere assegnata 
una stringa identificativa univoca contestual- 
mente alla sua registrazione presso YMBean 
Server. È corretto ed in puro approccio OOP asse- 
gnare la responsabilità di conoscere la propria 
stringa identificativa al MBean stesso. La stringa 
viene costruita concatenando il nome del packa- 
ge e della classe del bean. Oltre a ciò tutti i nostri 
MBean dovranno tenere sotto controllo un'istan- 
za di Server. Anche in questo caso è più elegante 
settare il puntatore all'istanza di Server da gesti- 
re in questa super classe, di cui è riportato sche- 
maticamente il codice. Il costruttore accetta 
un'istanza di Server, che sarà l'oggetto gestito. Il 
nome deìYMBean viene generato dal metodo 
getObjectNameStringO '. In JMX il nome dell'og- 
getto non è una semplice stringa ma un oggetto 
di tipo ObjectName. 

public class MBean { 

private ObjectName myName; 
private Server managed; 
public MBean(Server managed) { 
String ObjectName = nuli; 

try { 

ObjectName = getObjectNameStringO; 
myName = new ObjectName(objectName); 
} catch (MalformedObjectNameException e) { 
throw new RuntimeException(objectName 

+ " is a malformed ObjectName", e);} 
this. managed = managed;} 
public ObjectName getObjectNameQ {return 



myName;} 

public Server getManaged() {return managed;} 
public String getObjectNameStringO { 
String domain = 

this.getClass().getPackage().toString(); 



String name 



this.getClass().getSimpleName(); 



return domain + ":type=" + name; } 




} 



Definiamo a questo punto l'implementazione vera e 

propria del MBean che ovviamente implementerà 

l'interfaccia StatisticheMBean ed estenderà la classe 

MBean. L'implementazione si limita ad invocare i 

corretti metodi sul server per restituire i dati della 

statistica. 

L'implementazione è abbastanza semplice. 

package ioprogrammo. server. management; 

import ioprogrammo. server. Server; 

import java. util. Date; 

public class Statistics extends MBean implements 

StatisticsMBean { 
public Statistics(Server managed) { 

super(managed); } 
public int getMaxUserAllowedO { 

return getManaged(). getMaxUserAllowedO; } 
public int getNumberOfRegisteredUserO { 
return 
getManaged(). getNumberOfRegisteredUserO;} 
public void shutdown() { 

getManaged().halt(); } 
public Date getBootTime() { 

return getManaged().getUpTime();} 
public long getUpTime() { 

return (int) (.001 * (new Date().getTime() - 

getBootTime().getTime())); } 
public doublé getRegisteredUserPerHour() { 
doublé hour = (doublé) getUpTime() / 3600; 
return getManaged() 

.getNumberOfRegisteredUserO / hour; } 



REGISTRAZIONE 

DEL MBEAN NEL MBEAN 



La procedura da eseguire per registrare un MBean in 
un MBean server è abbastanza lunga e assoluta- 
mente ripetitiva. Si deve eseguire il lookup del ser- 
ver, creare Y ObjectName da associare al nuovo 
MBean, registrarlo e gestire eventuali eccezioni. Non 
è quindi pensabile ripetere tutta la procedura ogni 
volta che sia necessario registrare un MBean. Per 
non appesantire il codice di chiamate ripetute defi- 
niamo una classe di supporto che si occupa della 
registrazione degli MBean, attraverso il metodo 
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registerMBeanO. Il metodo chiede al MBean stesso la 
sua stringa di registrazione. Nel codice, a scopo illu- 
strativo, sono riportate tutte le eccezioni che posso- 
no essere sollevate. Probabilmente si potrebbe opta- 
re per un più conveniente catch (Exception e). 
La classe a cui richiedere la registrazione degli 
MBean è MbeanServer che può essere ottenuta dalla 
classe ManagementFactory attraverso il metodo get- 
PlatformMBeanServerO che restituisce un puntatore 
al MbeanServer di default per l'istanza della JVM su 
cui sta girando l'applicazione. Come è possibile no- 
tare la registrazione del bean non presenta eccessive 
difficoltà. È sufficiente invocare il metodo register- 
MBeanO passando l'implementazione del bean e 
YObjectName da associargli. Le eccezioni sollevate 
riguardano il fatto di aver utilizzato un ObjectName 
già utilizzato da un diverso MBean già registrato, un 
generico problema durante la registrazione ed infi- 
ne il tentativo di registrare un MBean che non rispet- 
ti le specifiche JMX, ad esempio perché permette di 
impostare delle proprietà di un tipo non supportato 
o perché non rispetta i vincoli sui nomi delle inter- 
facce. 

package ioprogrammo. server. management; 
public class MBeanHelper { 

private static final MBeanServer mBeanServer = 

ManagementFactory.getPlatformMBeanServer(); 
private MBeanServer getMBeanServer() { 

return mBeanServer; } 
public void registerMBean(MBean mBean){ 
MBeanServer mbs = getMBeanServerQ; 



try { 



mbs.registerMBean(mBean, 

mBean.getObjectNameO); 
} catch (InstanceAIreadyExistsException e) { 



e.printStackTraceQ; 



} catch (MBeanRegistrationException e) { 



e.printStackTraceQ; 



} catch (NotCompliantMBeanException e) { 



e.printStackTraceQ; } } 



Ora dobbiamo modificare il server affinchè in fase di 
startup registri V MBean presso il MbeanServer. Per 
fare ciò ci vengono in aiuto i metodi startupO e shut- 
down() che tanto saggiamente avevamo previsto 
nella stesura del server. Nel metodo startup quindi 
creeremo un Mbean di tipo StatisticsMBean e ne 
delegheremo la registrazione alla classe di supporto 
appena creata. Scriviamo quindi il corpo del meto- 
do startup. 

private void startupQ { 

System. out.println("starting up"); 
MBeanHelper. instance().registerMBean( 

new Statistics(this)); 



COLLEGARSI 

coni jcomsole 

Aprite la directory dove è installato il Java Develop- 
mentKit (attenzione non il JRE), portatevi nella car- 
tella "bin" e lanciate "jconsole". Nella schermata ini- 
ziale scegliete la linguetta "remote", come "host" 
immettete "localhost", come "port"\o stesso numero 
che avete specificato in corrispondenza del pa- 
rametro com.sun.management.jmxremote.port, in 
questo caso 8090 e cliccate su connect. Se tutto pro- 
cede correttamente apparirà una finestra che mo- 
strerà nella sezione sinistra tutti gli Mbeanregistrati 
suddivisi in categorie. Le prime categorie rag- 
gruppano tutti gli MBean della Java virtual machine. 
Spiegare i significati di tutti gli MBean pubblicati 
della Java Virtual Machine è fuori dagli scopi dell'ar- 
ticolo, tuttavia alcuni di essi sono autoesplicativi. 
L'ultima categoria è "package ioprogrammo. ser- 
ver.managemenf. Aprendo tale categoria scegliete il 
bean "Statistics" e vedrete elencati tutti i parametri 
esposti daR' MBean. Facendo doppio click su uno dei 
parametri di tipo intero è anche possibile vedere un 
evoluzione temporale del parametro stesso. 
Ecco quindi che lo stato dell'applicazione è visibile e 
consultabile via web tramite JMX. 



LANCIARE IL SERVER 



Dopo aver compilato 
l'applicativo eseguitelo avendo 
cura di impostare i parametri 
specificati. Il parametro "port" 
identifica la porta TCP su cui si 
deve mettere in ascolto il Mbean 
Server. Potete scegliere una 
qualunque porta libera. 
I parametri "authenticate" e 
"ssl" a false disabilitano 
qualsiasi impostazione di 
sicurezza, in modo che questo 



primo esempio possa girare 
senza problemi. 
Nei successivi articoli appro- 
fondiremo anche tale aspetto. 

java -Dcom. su n. management 

.jmxremote -Dcom. sun. management 

.jmxremote.port=8090 -Dcom. sun 

.management.jmxremote. authenticate 

=false -Dcom. sun. management 

.jmxremote. ssl= false 

ioprogrammo. Server 



CONCLUSIONI 

I concetti che stanno alla base di JMX non sono 
complessi e l'utilità è indiscutibile. Nel nostro esem- 
pio abbiamo complicato leggermente le cose crean- 
do una superclasse da cui derivare e una classe per 
la registrazione, tuttavia questa metodologia vi con- 
sentirà di risparmiare molto tempo nel momento in 
cui vorrete utilizzare questa tecnologia in fase di 
produzione. 

Ci sono ancora molte cose da dire rispetto a JMX. 
Sicuramente torneremo sull'argomento nei prossi- 
mi numeri. 

Daniele De Michelis 
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INSTALLAZIONI 
IN UN CUCK(ONCE) 

UTILIZZIAMO UNA DELLE ULTIME TECNOLOGIE DI CASA MICROSOFT PER DISTRIBUIRE 
IN MODO EFFICACE LE NOSTRE APPLICAZIONI SENZA DOVERCI PREOCCUPARE DI FUTURI 
AGGIORNAMENTI E DELL'OMOGENEITÀ DELLE VERSIONI INSTALLATE 





j Basi di 



programmazione .NET 



§ 



.NET2.0 



^3 



Tempo di realizzazione 







uali sono i problemi legati all'installa- 
zione del software? È facile fornire qual- 
che riposta immediata: 



1) Difficoltà nella distribuzione degli aggiorna- 
menti. 

2) Difficoltà nel deployment delle applicazioni. 

Sembrerebbero due problemi di facile soluzio- 
ne. Tuttavia ci accorgeremo che proprio la fase 
di installazione della versione finale e delle ver- 
sioni intermedie di un'applicazione rappresen- 
ta da solo uno degli scogli più importanti per 
uno sviluppatore. Nonostante la distribuzione 
di un'applicazione sia il passo finale del ciclo di 
produzione, non deve essere considerata ulti- 
mo anche in ordine di importanza. Stabilire a 
priori la modalità di distribuzione e installazio- 
ne del software è fondamentale per una buona 
riuscita del prodotto. Spesso le applicazioni de- 
vo essere immediatamente fruibili da parte del- 
l'utente finale, facilità di installazione e manu- 
tenzione costituiscono requisiti importantissi- 
mi. Questo tipo di problematica ha favorito nel 
corso del tempo lo sviluppo di applicazioni Web 
che per loro natura non necessitano di installa- 
zione e vengono aggiornate semplicemente lato 
server. D'altro canto è noto che lo sviluppo di 
applicazioni Web non ha per certi versi la stessa 
flessibilità di un'applicazione standalone. Da 
qui la necessità di un modello capace di rende- 
re semplice e sicura la distribuzione delle ap- 
plicazioni client, su un piano simile alla distri- 
buzione delle applicazioni Web. ClickOnce con- 
sente di ottenere esattamente questo: una 
distribuzione semplice, efficace, sicura delle 
applicazioni Windows, non invasiva sul client di 
destinazione. Ovviamente non tutte le applica- 
zioni possono usufruire di questo modello. 
Proveremo ora ad analizzare le caratteristiche di 
ClickOnce per valutare in che modo può esserci 
utile nel lavoro di tutti i giorni. Immaginiamo di 
dover sviluppare un'applicazione per un nostro 
ipotetico cliente, la cui necessità sia quella di 



implementare un servizio di registrazione ana- 
grafiche distribuito, rilasciato a tutte le sue 
agenzie geograficamente distanti tra loro. Ogni 
agenzia utilizza il software myAnag per registra- 
re quotidianamente i dati dei nuovi clienti 
acquisiti. Va da sé che tutte le agenzie devono 
possedere in ogni determinato istante la stessa 
identica versione del software myAnag. 



PRIMA DISTRIBUZIONE 
CON CLICKONCE 

Terminata la fase di progettazione, sviluppo e 
test della nostra applicazione, siamo pronti a 
procedere con la distribuzione su tutti i client. 
Apriamo la nostra soluzione in Visual Studio 
2005 ed accediamo al modello di distribuzione 
ClickOnce attraverso il menu Build/Compila | 
Publish nomeApp, dove nomeApp rappresenta il 
nome dell'applicazione che stiamo distribuen- 
do. Visual Studio 2005 presenta un wizard che 
permette la selezione della modalità di distribu- 
zione che desideriamo applicare. La prima 
scheda del wizard consente di scegliere tra 
quattro diverse modalità: una cartella sul disco, 
una condivisione di rete, un server FTP o un sito 
web. In realtà è anche possibile distribuire l'ap- 
plicazione utilizzando supporti come CD, DVD 



Mi 



Where do you want to publish the application? 



Specie";.- the location co publish this application: 



You may publish the application to a web site, FTP server, or 

Examples: 

application 
File share: \\server\nnyapplication 
FTP server : i i m/m /application 

Website: http://ww fi i ppli 



# 



\ Next > 1 [ Finish ] 



Fig. 1: Impostiamo il percorso di pubblicazione 
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o Pen Drive. Data la differente posizione geogra- 
fica dei client, scegliamo di distribuire myAnag 
attraverso un server web, specificando, appun- 
to, il percorso di pubblicazione in forma di URL. 
La seconda scheda del wizard chiede di impo- 
stare la modalità di esecuzione dell'applicazio- 
ne sul client. L'applicazione può, infatti, essere 
resa disponibile in due modi: online e offrine, 
oppure solo online. Nella prima ipotesi viene 
creato un collegamento dal menu start di Win- 
dows e l'applicazione può anche essere disin- 
stallata, con il vantaggio di poter eseguire l'ap- 
plicazione anche senza essere connessi al sito 
web di pubblicazione. Nella seconda ipotesi i 
client devono, invece, connettersi ogni volta al 
sito di pubblicazione per poter eseguire l'appli- 
cazione. 



Will the application be avallatile offline? 



# 






(.':• Yes, this ai plication i i iìafal nlin ili 

A shortcut will be added to the Start Menu, and the application :an fai 
via Add/Remove Programs, 

MOj this applii j i I ailable online 

No shortcut will be added :o the Stai t Mefiti, rhe application will be ri 
frorn the publish location, 



e Previeni? f-Jext ::= 



Fig. 2: Impostiamo la modalità di installazione 

Selezioniamo la seconda ipotesi e terminiamo il 
wizard. Visual Studio compila il progetto, crea i 
file di pubblicazione ed infine copia i file in una 
cartella all'interno della directory da noi specifi- 
cata. Viene creata una cartella, il cui nome è 
composto dal nome dell'applicazione più il nu- 
mero di versione pubblicato, contenente tutti i 
file associati al deploy corrente. Al termine della 
procedura di pubblicazione, Visual Studio 2005 
mostra la pagina Web generata dove sostanzial- 
mente vengono riportati il nome dell'applica- 
zione, l'ultima versione pubblicata e, se dispo- 
nibile, l'eventuale publisher. Utilizzando l'URL 
di pubblicazione, quindi, i client possono ese- 
guire l'applicazione cliccando sul tasto Run. A 
questo punto il runtime ClickOnce esegue i con- 
trolli di sicurezza per verificare innanzitutto se 
l'applicazione è firmata e se la firma è valida, e 
poi, tramite Code Access Security, se i permessi 
richiesti sono compatibili con quelli impostati 
per l'esecuzione o l'installazione dalla Internet 
Zone, che è la zona di provenienza/ pubblicazio- 
ne che stiamo utilizzando. Qualora almeno uno 
di questi controlli fallisse, ci verrà mostrato un 
Security Warning, una window che chiede all'u- 



Publisher cannot be verified. 

Are you sure you want to instali this application? 



Nanne: MyAnag 

Frorn: vmfabio-pp9xvgl 

Publisher: Unknown Publisher 



* 



Instali [ Don't Instali 



'ii • ii , ■ i ii i 




Fig. 3: La security warning 

tente una conferma sull'azione da eseguire, cioè 
se l'applicazione deve essere eseguita o meno. 
Confermiamo l'esecuzione cliccando su Run. 
Come possiamo vedere l'applicazione viene 
correttamente eseguita. 



31 myAnag 
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Fig. 4: L'applicazione in esecuzione sul client 

La Security Warning può essere evitata e vedre- 
mo come fare firmando l'applicazione ClickOn- 
ce e impostando i permessi per una corretta ese- 
cuzione. 



ESECUZIONE 
DELL'APPLICAZIONE 
IN MODALITÀ OFFLINE 

Supponiamo che ora il nostro cliente desideri 
rendere l'applicazione utilizzabile anche da 



DISINSTALLAZIONE 

DELLE APPLICAZIONI CLICKONCE 



La modalità di installazione offline, 
oltre ad aggiungere un collega- 
mento dal menu Start di Windows, 
consente anche di rimuovere la ver- 
sione installata dell'applicazione 
ClickOnce ripristinando la versione 
precedente, utilizzando il tool di 



Windows Add/Remove Programs, 

accessibile dal Pannello dì 

Controllo. 

La stessa procedura può essere 

utilizzata per rimuovere 

definitivamente l'applicazione dal 

sistema client. 
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quei client che non sono sempre connessi alla 
rete, modificando appunto un requisito fonda- 
mentale della prima distribuzione. Nessun pro- 
blema. Riapriamo la soluzione in Visual Studio 
2005 e rieseguiamo la distribuzione sempre uti- 
lizzando il menu Build | Publish myAnag. Nel 
wizard lasciamo invariato il percorso di pubbli- 
cazione e modifichiamo, invece, l'opzione di 
disponibilità dell' applicazione impostando la 
modalità online e offrine, come visualizzato in 
Figura 5, e terminiamo il wizard. 



Will the application be available offline? 






VeSj this i or oFFIine 

A shortcut will be added tu the Start Menu, and the application can Le 
via Add/Remove Programs. 

O No, this applir ii i ailable online 

Ho shortcut will be added to the Start Menu. The application will be ri 
from the publish location. 



js Next > 



Finish Cancel 



Fig. 5: Consentiamo l'esecuzione anche offline 

Visual Studio 2005 riesegue la compilazione del 
progetto, incrementando il numero di build, e 
riesegue la pubblicazione del progetto nella car- 
tella da noi indicata. Ora la pagina di publish 
presenta ancora una volta il nome dell'applica- 
zione, il numero di versione, questa volta incre- 
mentato di build, e non più il tasto Run, ma il 
tasto Instali. Cliccando su instali ClickOnce rie- 
segue i controlli di sicurezza, visualizzando la 
Security Warning qualora non validi, provvede 
ad eseguire una installazione dell'applicazione 
sul client e infine esegue l'applicazione appena 
installata. La differenza con la precedente 



I FILE MANIFEST DI CLICKONCE: 
.DEPLOY E .APPLICATION 



La distribuzione e l'esecuzione delle applicazioni ClickOnce sono basate su 
due fondamentali file manifesti 



.deploy 



.application 



descrive le informazioni di distribuzione su cui spiccano la 
descrizione della versione attualmente disponibile, il 
riferimento all'application manifest, le modalità di 
installazione e di update dell'applicazione e la firma del 
manifest di deploy; 



descrive nel maggior dettaglio l'applicazione distribuita 
con ClickOnce, riportando le informazioni di 
identificazione sull'assembly principale distribuito e su 
tutte le sue relative dipendenze. 



L'esecuzione dell'applicazione è associata al file .application il cui 
percorso è passato come parametro alla libreria dfshim.dll eseguita 
utilizzando il comando rundll.exe. 



modalità di distribuzione è data dalla presenza 
di un collegamento, nel menu Start | Programmi 
di Windows, che consente di eseguire l'applica- 
zione myAnag anche se non si è connessi alla 
rete o comunque al percorso di pubblicazione. 
L'installazione sul client non è reale o co- 
munque non simile a quanto avviene con il mo- 
dello di setup classico. L'applicazione viene in 
pratica installata localmente nella cache di 
ClickOnce ed eseguita da quella posizione dopo 
aver verificato che nella cartella di pubblicazio- 
ne, se disponibile, non è presente una nuova 
versione, nel qual caso viene chiesto se ef- 
fettuare l'aggiornamento. 



UPDATE 
DELL'APPLICAZIONE 

Supponiamo che venga richiesto di sostituire, 
nel nostro form di inserimento anagrafiche, il 
campo di testo per l'inserimento delle regioni 
con una combo box che, in maniera più sempli- 
ce, ne consente la selezione. Dopo aver aggior- 
nato l'applicazione ripetiamo il processo di pub- 
blicazione visto nel precedente paragrafo. Al ter- 
mine del processo di generazione della nuova 
build e della successiva pubblicazione da parte 
del wizard, Visual Studio 2005 mostra ancora 
una volta la pagina di pubblicazione. Ora, per 
verificare che l'update dell'applicazione funzio- 
na correttamente, proviamo ad eseguire l'appli- 
cazione dal menu start di Windows, proprio 
come farebbe un ipotetico utente. Il risultato è 
quello che possiamo vedere in Figura 6. 





Application update 


£» 

* 


Nanne: MyAnag 

From: vmfabio-pp9Kvgl 




1 U II 


ShJp 





Fig. 6: Il prompt che avvisa della disponibilità di una 
nuova versione 

ClickOnce accerta la presenza di una nuova ver- 
sione e chiede all'utente se desidera effettuare 
l'aggiornamento. Come avviene il processo? 
Internamente viene generato un hash per ogni 
build dell'applicazione. Se la cartella di pubbli- 
cazione è disponibile, ClickOnce verifica l'hash 
installato con l'hash della versione più recente 
disponibile. Se quest'ultimo è maggiore a quello 
installato, ClickOnce avvisa l'utente della dispo- 
nibilità di una nuova versione e chiede se ese- 
guire l'aggiornamento, altrimenti procede con 
la normale esecuzione dell'applicazione. Al ter- 
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mine dell' aggiornamento, ClickOnce esegue la 
nuova versione dell'applicazione installata. 



AGGIORNARE 

L'APPLICAZIONE 

PROGRAMMATICAMENTE 

Questo approccio va bene per gli aggiornamen- 
ti poco frequenti. Ma se si prevedono aggiorna- 
menti frequenti, anche durante l'utilizzo del- 
l'applicazione, come possiamo notificare ai 
client la presenza di nuovi aggiornamenti sul 
server? ClickOnce si avvale di un set di API di- 
sponibili attraverso il namespace System. Deploy- 
ment. Tale namespace consente, infatti, di verifi- 
care la disponibilità di nuove versioni ed even- 
tualmente di procedere al download. Predispo- 
niamo quindi un box dove un alert ci avvisa del- 
la presenza di aggiornamenti, ed un button che 
consente di aggiornare l'applicazione. Aggiun- 
giamo al form un controllo GroupBox ed inseria- 
mo al suo interno un controllo label ed un but- 
ton. Aggiungiamo poi al form un controllo timer 
che ad intervalli regolari verifica la presenza di 
aggiornamenti. 



this.IblUpdate.Text = "E disponibile una 

nuova versione.' 




Occurs whenever the specified interval tirine 
elapses. 



Fig. 7: La property box e la gestione dell'evento Tick 

Impostiamo il timer su un intervallo di 30 
secondi modificando la proprietà Interval su 
30000, in millisecondi. Selezioniamo il metodo 
da richiamare allo scadere dell'intervallo impo- 
stando il valore dell'evento Tick su CheckUpdate 
e premiamo invio sulla propertybox per genera- 
re il relativo codice. 

Nel codice del form importiamo il namespace 
System. Deployment. Application: 

using System. Deployment. Application; 

nel metodo CheckUpdate inseriamo il seguente 
codice: 

ApplicationDeployment deploy = 
ApplicationDeployment.CurrentDeployment; 
if (deploy.CheckForUpdate()) 



this.btnUpdate.Enabled = true; 



else 



this.IblUpdate.Text = "Nessun 

aggiornamento disponibile.' 
this.btnUpdate.Enabled = false; 



LA CODE ACCESS SECURITY 




La CAS è presente fin dalla prima 
versione del Microsoft .NET 
Framework e consente di prevenire 
l'esecuzione di codice non 
attendibile o che richiede elevati 
permessi per essere eseguito. Il 
runtime verifica, al caricamento di 
un assembly, la sua attendibilità 
sulla base della cosiddetta 
evidence, calcolata utilizzando 
parametri come la firma 
dell'assembly via strong-name o 



certificato digitale, la sua zona di 
esecuzione, ecc., utilizzandola per 
identificare il gruppo di codice di 
appartenenza e i relativi permessi 
di esecuzione. I gruppi di codice 
(code group) vengono 
generalmente determinati dagli 
amministratori di sistema. 
Se i permessi richiesti non 
coincidono con il gruppo di codice 
di riferimento, il runtime genera 
una eccezione di sicurezza. 



ApplicationDeployment è la classe più impor- 
tante del namespace in quanto, oltre a gestire gli 
aggiornamenti, consente di operare sull'istanza 
corrente, recuperare le informazioni di deploy, 
verificare se l'applicazione viene eseguita per la 
prima volta, fino ad operazioni più complesse 
come il download di assembly o gruppi di as- 
sembly non ancora installati, operazione che 
vedremo più avanti. La proprietà statica Cur- 
rentDeployment consente di recuperare l'istanza 
corrente e di verificare la presenza di nuove ver- 
sioni utilizzando il metodo CheckForUpdateQ. 
Se sono presenti nuove versioni nella cartella di 
pubblicazione, viene abilitato il pulsante btn- 
Update che permette di eseguire il codice per 
l'aggiornamento. Nel gestore dell'evento click 
del pulsante btnUpdate inseriamo, quindi, il se- 
guente codice: 

ApplicationDeployment deploy = 
ApplicationDeployment. CurrentDeployment; 
deploy.UpdateCompleted += new 

AsyncCompletedEventHandler( 
deployJJpdateCompleted); 
deploy.UpdateAsync(); 

Al click sul pulsante recuperiamo l'istanza cor- 
rente, impostiamo il gestore per l'evento Updat- 
eCompleted e avviamo l'aggiornamento in mo- 
dalità asincrona richiamando il metodo Update- 
Async. È anche possibile effettuare l'aggiorna- 
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Proprietà 


Descrizione 


AvailableVersion 


Proprietà di tipo Version contenente la nuova 
versione disponibile 


IsUpdateRequired 


Indica se l'aggiornamento è richiesto per il 
corretto funzionamento dell'applicazione 


MinimumRequiredVersion 


Di tipo Version indica la versione minima 
richiesta per poter effettuare l'aggiornamento 


UpdateAvailable 


Valore booleano che indica se un 
aggiornamento è disponibile 


UpdateSizeBytes 


Restituisce la dimensione dei file da aggiornare 


.Tabella /.- aaa > 



Application. Resta rt(); 



mento in modalità sincrona utilizzando il meto- 
do Update che ritorna true se il download e l'in- 
stallazione è andata a buon fine e false se l'ope- 
razione non è riuscita. Al termine dell'aggiorna- 
mento, possiamo continuare a lavorare con la 
versione corrente ed ottenere la nuova versione 
solo alla successiva esecuzione, oppure, sempre 
attraverso il codice, chiediamo all'utente di 
riavviare l'applicazione per completare l'aggior- 
namento. Per ottenere questo risultato inseria- 
mo il seguente codice nel gestore dell'evento 
UpdateCompleted: 

void deploy_UpdateCompleted(object sender, 

AsyncCompletedEventArgs e) 

{ 

DialogResult result = 

MessageBox.Show("Aggiornamento 

completato! Riavviare l'applicazione?", "", 
MessageBoxButtons.YesNo, 

MessageBoxIcon.Question); 



if (result == DialogResult. Yes) 



{ 



} 



Con veramente poche righe di codice è possibi- 
le gestire un'operazione complessa come quella 
dell'update in tempo reale dell'applicazione sul 
client. È importante sottolineare, però, che l'ap- 
plicazione così impostata necessita di richiede- 
re i permessi massimi di esecuzione (Full Trust). 
È anche possibile recuperare le informazioni 
sulla nuova versione disponibile utilizzando il 
metodo CheckForDetailedUpdateO, che restitui- 
sce un'istanza dell'oggetto UpdateChecklnfo. 
L'oggetto contiene le proprietà ruportate in Ta- 
bella 1. 



DOWNLOAD OHI DEMAND 

Nella modalità di distribuzione via internet po- 
tremmo trovarci di fronte a client che non di- 
spongono di una larghezza di banda tale da 
consentire una agevole esecuzione dell'applica- 
zione. In quest'ottica è opportuno, e a volte ne- 
cessario, minimizzare i file da includere nell'in- 
stallazione, riducendo quindi il tempo di down- 
load e di startup dell'applicazione. ClìckOnce 
consente di installare gli assembly o i files anche 
successivamente, utilizzando le API incluse in 
System .Deployment, ed introducendo il concet- 
to di late- download o download a gruppi. Sup- 
poniamo di voler fornire un controllo aggiunti- 
vo, ad esempio un controllo calendar, utilizzato 
dai client solo in alcuni casi e contenuto in un 



DISTRIBUIRE IN 



III 



TRADIZIONALE 



La distribuzione delle applicazioni può avvenire anche attraverso supporti come CD o DVD. Questo è possibile 



> CREAZIONE DEL FILE 
AUTORUN.INF 




Impostiamo nelle Op- 
zioni della scheda 
Publish delle proprietà del 
progetto la creazione del 
file autorun.inf per con- 
sentire l'avvio automatico 
del setup. Possiamo inseri- 
re anche altre informazio- 
ni quali ad esempio il no- 
me del publisher, il nome 
del prodotto, un eventuale 
indirizzo web per il sup- 
porto onLine, altre infor- 
mazioni di vario genere 



> SELEZIONE DI UNA 
CARTELLA DEL FILE SYSTEM 



ri in fuMtin «w Jff* aMwi 7 




minta; tatpjfr 



l »*, i neri i « l 



Nella prima scheda, impostiamo co- 
me destinazione della pubblicazione 
una cartella sul disco. 
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assembly esterno alla nostra applicazione. Ag- 
giungiamo un riferimento alla libreria conte- 
nente il controllo ed inseriamo il codice neces- 
sario per poterlo richiamare (il codice completo 
è disponibile sul ed allegato alla rivista). Senza 
pesare sullo startup dell'applicazione è possibi- 
le creare gruppi di files e avviare il download dei 
file non installati solo quando necessario. 
Facciamo click con il tasto destro sul progetto e 
clicchiamo su proprietà, richiamiamo la scheda 
Publish e clicchiamo su ApplicationFiles. Ci vie- 
ne mostrata una dialog box contenente l'elenco 
dei file che saranno distribuiti via ClickOnce, 
ognuno con lo stato di pubblicazione e il grup- 
po di download di appartenenza. Lo stato di 
pubblicazione può assumere tre valori: Include, 
indica che il gruppo è incluso dall'installazione 
di base, Prerequisite, che imposta il gruppo 
come un prerequisito fondamentale per il fun- 
zionamento dell'applicazione, e Exclude, che 
esclude il gruppo dall'installazione di base. 
Esiste solo un gruppo creato di default ed è 
(Required), ma è possibile crearne di nuovi clic- 
cando su New ed impostando il nuovo gruppo, 
che viene poi direttamente assegnato al file 
selezionato. Utilizzando questa sequenza creia- 
mo il gruppo controls e lo assegniamo alla li- 
breria di controlli precedentemente aggiunta 
alla soluzione. Prima di richiamare ed eseguire il 
codice contenuto in un controllo appartenente 
al gruppo controls, dobbiamo verificare se gli 
assembly e i file relativi sono stati già scaricati 
ed installati sul client. In caso contrario proce- 
diamo con il download. Il codice da implemen- 
tare è simile al seguente: 



ApplicationDeployment deploy 



ApplicationDeployment.CurrentDeployment; 
if (!deploy.IsFileGroupDownloaded("controls")) 



{ 



deploy. DownloadFileGroup("controls"); 



> 



// qui il codice da eseguire 

Il codice sopra riportato, verifica se il gruppo 
denominato controls è stato già scaricato dalla 
cartella di pubblicazione ed eventualmente 
procede al download della libreria di controlli. 
Nell'applicazione myAnag questo avviene prima 
della chiamata al form contenente il controllo 
che andremo ad utilizzare. Al pari della proce- 
dura di upload è possibile utilizzare anche il 
metodo asincrono DownloadFileGroupAsync e 




IMPOSTARE MANUALMENTE LE BUILD 



Ad ogni pubblicazione, ClickOnce 
incrementa il numero di build per 
distinguere le versioni e consentire 
al runtime di verificare la presenza 
di aggiornamenti. Spesso però que- 
sta procedura genera build non ne- 
cessarie. È possibile infatti rimuo- 



vere questa caratteristica e sceglie- 
re di impostare manualmente il nu- 
mero di build deselezionando il 
controllo check box per l'incremen- 
to automatico della scheda Publish, 
nelle proprietà del progetto da di- 
stribuire. 




Publish Version 



Major: 




Minor: 




Build: 




Re vision: 


1 














32 



]] Autornatically increment revision with each publish 



Impostare manualmente la build 



sfruttando la distribuzione attraverso file system nel Publish Wizard 



> INSTALLAZIONE 
ATTRAVERSO CD DVD 



1 taw uri! uun tautjtf Hip jff^alkviT 










^ 


O pi«'«» <** 




O *4»*iKn*i ****** 




Q nW*OM0H«rVW«CH 


1 ^» 


- Jl 


MMt> 




** 


Jl ^ 1 



La seconda scheda chiede la moda- 
lità di installazione dell'applicazione. 
Selezioniamo installazione da cdrom/dvd 



> MODALITÀ 

DI AGGIORNAMENTO 







^ 




.*;• ih» iffitieyi mi «hi^fe n#j**t*<t* a^ia^4Ikw< 
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Viene chiesto se l'applicazione deve 
verificare la presenza di aggiorna- 
menti e qual è l'indirizzo di riferimento 



> LA CARTELLA 
DI PUBBLICAZIONE 



—jHSffiHHi 


; File Modi! feriti Strumenti ? 


i) Indietro " O Cerca [f>> Cartelle 


EDI- 


: IndirizE C:\myDeploy\myAnag v EJ Vai 


^ myAnag. application 
\ myAnag 1 30 Là Application Manifest 
l ■* | 3 6 KB 

myAnag_l_0_0_30. application ^^ autorun.inf 
Lj» Application Manifest , vi/ 
I U 6 kb r_3^ 1 KB 

ky^ setup.exe 



Ecco i file che troviamo nella cartel- 
la di pubblicazione e che sarà poi di- 
stribuita su CD o DVD. 
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gestire l'evento DownloadFileGroupCompleted 
per catturare il termine del download. 



CLICKONCE E LA 

CODE ACCESS SECURITY 

A differenza delle normali applicazioni .NET, le 
applicazioni ClickOnce seguono un processo di 
esecuzione leggermente differente. Come pote- 
te notare dai link riportati dalla pagina publish 
.htm, viene eseguito un file * application che al- 
tro non è che il deployment manifest, un file 
XML dove sono descritte informazioni stretta- 
mente legate alla pubblicazione attraverso 
ClickOnce come, ad esempio, l'identità dell'ap- 
plicazione e come essa deve essere distribuita. 
Il file .application viene eseguito perché associa- 
to alla libreria di classi COM dfshim.dll, eseguita 
attraverso la stringa 

rundll32.exe dfshim.dll, ShOpenVerbApplication %1, 

dove %1 rappresenta, appunto, il percorso com- 
pleto del file .application. Dal manifest viene re- 
cuperato il file da eseguire e che sarà sottoposto 
alle regole di Code Access Security (CAS). Per me- 
glio descrivere il meccanismo che muove la CAS 
sarebbe necessario un articolo dedicato, ma vo- 
lendo esprimerlo con poche parole, e relativa- 
mente all'ambito di nostra competenza, possia- 
mo dire che è il processo di verifica e validazio- 
ne dei permessi di un assembly dipendente- 
mente dalla zona in cui esso viene eseguito. 
Come detto anche le applicazioni ClickOnce 



CALCOLARE AUTOMATICAMENTE 
I PERMESSI DI ESECUZIONE 



Anche le applicazioni ClickOnce so- 
no sottoposte, come abbiamo vi- 
sto, al controllo della Code Access 
Security. Per questo motivo è im- 
portante dichiarare quelli che sono 
i permessi di esecuzione che si ri- 
chiedono e che andranno a formare 
il permission set dell'assembly. 
ClickOnce consente di impostare 
sia manualmente, sia utilizzando 
procedure guidare il livello di sicu- 
rezza da applicare. Attraverso la 
scheda Security è possibile, infatti, 
dichiarare l'applicazione come Par- 
tially Trusted ed impostare la zona 
da cui sarà eseguita. ClickOnce cal- 
colerà i permessi relativi alle impo- 
stazioni date. Se, ad esempio, im- 
postiamo la zona Internet, verran- 
no attribuiti i permessi minimi di 
esecuzione (FileDialogPermission, 
IsolatedStorageFilePermission, Se- 
curityPermission, UlPermission e 



PrintingPermission). Ma se l'appli- 
cazione richiede in realtà permessi 
maggiori, come ad esempio, la 
scrittura sul file system identificata 
dal FilelOPermission, verrà genera- 
ta una eccezione. 

In alternativa è possibile calcolare i 
permessi necessari cliccando sul 
tasto CalculatePermission. 
ClickOnce, infatti, legge via reflec- 
tion l'albero dei riferimenti e recu- 
pera le richieste di permessi del co- 
dice referenziato. 






Calcolare I permessi di esecuzione 



sono sottoposte al controllo della CAS e devono 
perciò dichiarare quelli che sono i permessi che 
richiedono per essere eseguiti. Nel nostro caso 
l'applicazione myAnag viene eseguita o installa- 
ta attraverso la Internet Zone, motivo per cui gli 
vengono garantiti i diritti minimi di esecuzione. 
Se, viceversa, myAnag necessita e richiede dirit- 
ti di esecuzione superiori a quelli garantiti per la 
zona, ClickOnce chiederà all'utente di confer- 
marne l'esecuzione. Ma se dobbiamo distribui- 
re via internet e la nostra applicazione richiede 
diritti superiori a quelli possibili con la Internet 
Zone, come possiamo risolvere il problema per 
evitare la poco gradevole Security Warning? 
Abbiamo due alternative: 

1) Distribuire l'applicazione utilizzando sup- 
porti removibili come CD o DVD, che otten- 
gono i permessi di una zona Full-Trust, pur 
mantenendo la modalità di aggiornamento 
via internet; 

2) Ottenere un certificato digitale per garantire 
l'autenticità del codice; 

Con ClickOnce, infatti, è possibile firmare i file 
.application utilizzando certificati digitali rila- 
sciati da Certification A uthority riconosciute. 
Questo implica, però, un passaggio aggiuntivo 
che consenta la registrazione del publisher sul 
computer client, al fine di riconoscerlo come 
trusted. Dopo la registrazione nello store locale, 
saremo in grado di eseguire correttamente e 
senza errori la nostra applicazione ClickOnce. 



CONCLUSIONI 

Abbiamo visto come con la tecnologia ClickOn- 
ce, seguendo il caso e l'evolversi di un'applica- 
zione reale, sia possibile eseguire il deploy e 
l'aggiornamento anche di complesse applica- 
zioni client in modo semplice, facile e sicuro 
quasi quanto la distribuzione di applicazioni 
Web. È certo che ClickOnce non può essere uti- 
lizzato per tutti i tipi di installazione, special- 
mente quando si rende necessario eseguire 
operazioni locali complesse come la modifica 
del file di registro o la registrazione di compo- 
nenti, modalità consentita solo attraverso l'uso 
di Windows Installer. Il sistema ClickOnce, però, 
consente senza dubbio di diminuire quel gap, 
discusso all'inizio di questo articolo, tra la di- 
stribuzione di applicativi Windows e la distribu- 
zione di applicativi Web. Per ulteriori chiari- 
menti vi invito ad utilizzare il forum di ioPro- 
grammo oppure il mio blog riportato sul box 
laterale. Buona distribuzione. 

Fabio Cozzolino 
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PROGRAMMIAMO 



IL TASTO "F1 



II 



IN QUESTO ARTICOLO SFRUTTIAMO UN TOOL DI SUN: JAVAHELP PER COSTRUIRE UN SISTEMA 
DI DOCUMENTAZIONE EFFICACE PER LE NOSTRE APPLICAZIONI. VEDREMO COME GESTIRE 
L'ALBERO DEGLI ARGOMENTI E COME CREARE COLLEGAMENTI OPPORTUNI 




LICDU 



WEB 



^5f 



jn 



REQUISITI 



Conoscenze richieste 



u 



Basi di Java 



I 



Windows 98 o 
superiore, o Linux, 
un compilatore Java. 





LJ idea è molto semplice: realizzare un sistema 
di documentazione per le proprie applica- 
A zioni. Ora, se qualche volta avete premuto il 
tasto FI mentre lavoravate con un software, è proba- 
bile che vi sia comparso il famoso "Aiuto in linea". Il 
punto è che questo "Help On Line" per quanto a pri- 
ma vista possa sembrare privo di funzionalità im- 
portanti, ne ha invece alcune che è necessario im- 
plementare, se si vuole creare un sistema di docu- 
mentazione efficace. Come è possibile effettuare 
una ricerca per argomento? E per parola chiave? Co- 
me si indicizza la documentazione? A questo e a 
molto altro daremo una risposta in questo articolo. 



STRUMENTI 
E PRIMI PASSI 

JavaHelp è un sistema di help realizzato in Java pro- 
posto da Sun. I concetti che stanno alla base di Java- 
Help sono sufficientemente semplici: si scrive la do- 
cumentazione in HTML utilizzando una particolare 
logica, si descrive la struttura con cui questi file sono 
collegati tramite un file XML. In JavaHelp sono poi 
integrati strumenti per la ricerca di testo ed esistono 
particolari interfacce per collegare la documenta- 
zione a una qualsiasi applicazione Java. Con Java- 
Help è possibile costruire a mano un intero sistema 
di Help, difatti sia i documenti HTML che quelli XML 
sono facilmente editabili con qualsiasi programma 
per elaborazione di testo, compreso l'onnipresente 
notepad o un suo qualsiasi clone. Se tuttavia non si 
desidera avere a che fare direttamente con XML si 
possono usare anche appositi software. L'uso di 
strumenti particolari è consigliabile quando la di- 
mensione del help cresce e diventa sempre più dif- 
ficile gestire manualmente i riferimenti e i collega- 
menti tra i documenti. 



LA LISTA DELLA SPESA 

Scarichiamo prima di tutto il package Java Help. 
Aprite la pagina all'indirizzo http://java.sun.com 



/products/javahelp/ e seguite i link che portano alla 
versione JavaHelp 2.0_02, l'ultima rilasciata al 
momento della stesura dell'articolo. Scaricate il file 
JavaHelp 2.0_02.zip, comprensivo della libreria e 
della documentazione e scompattatelo in una car- 
tella di vostro gradimento. Il primo passo per redige- 
re l'help è quello di provvedere al contenuto. Creia- 
mo quindi una cartella che chiameremo "help" che 
conterrà tutti un insieme di file che costituiranno 
quello che chiameremo un "help set". All'interno di 
questa cartella, a titolo puramente esemplificativo, 
creiamo le due directory chiamate "argumentl " e 
"argument2". In ognuna di queste cartelle creiamo 3 
file HTML con nomi rispettivamente da "itemOOO 
.html" a "item003.html" nella prima e da "item004 
.html" a "item006.html" nella seconda. I documenti 
HTML del help set devono avere la solita struttura 
con header e body. 

<html> 
<head> 

<title>[...]</title> 

</head> 



<body> 



[-] 



</body> 



</html> 

Per l'esempio è sufficiente riempire il body con del 
testo qualsiasi. Lasciamo al lettore il compito di ri- 
empire il contenuto del file di help. Nei sorgenti che 
vengono forniti con l'articolo comunque i file di 
help di esempio sono compilati. L'unica nota da te- 
nere in mente nella stesura del contenuto degli help 
è di utilizzare percorsi relativi nel caso si inserisca un 
link tra un documento e l'altro. Se ad esempio si 
desiderasse inserire un link dal documento "item 
000. html" nella cartella "argumentl " al file "item004 
. html " nella cartella "argument2 " sarebbe necessario 
specificare un link siffatto. 

<a href ="../argument2/item004. html" >text</a> 

Questa precauzione permette di spostare l'help set in 
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qualsiasi directory senza pregiudicare la navigazione 
tra i documenti, a patto ovviamente di mantenere la 
struttura delle directory dell'help set costante. 



NOMINARE I DOCUMENTI 

La mappa del help set è il documento XML più im- 
portante del nostro progetto. Il file consente di asse- 
gnare una sorta di etichetta identificativa ad un file 
determinando una corrispondenza univoca tra file 
HTML e nomi. Nell'intero file di Help sarà dunque 
possibile riferirsi a un file utilizzando l'etichetta che 
gli è stata associata piuttosto che il suo percorso. 
Questo permette da un lato di risparmiare tempo 
per la digitazione dei nomi dei file, oppure di effet- 
tuare delle variazioni semplicemente modificando il 
puntatore associato a un file nella descrizione XML. 
L'unico vincolo riguarda l'estensione del file della 
mappa, è necessario infatti che tale file abbia esten- 
sione ".jhm". Per procedere create quindi il file "my_ 
map.jhm" come riportato di seguito. 

<?xml version = '1.0' encoding = 'ISO-8859-l' ?> 
<!DOCTYPE map PUBLIC "-//Sun Microsystems 

Inc.//DTD JavaHelp Map Version 1.0//EN" 
"http://java.sun.com/products/javahelp /map_l_0.dtd"> 
<map version = "1.0"> 

<mapID target="item001" url = 

"argumentl/itemOul.html" /> 
<mapID target="item002" url = 

"argumentl/item002.html" /> 
<mapID target="item003" url = 

"argumentl/item003.html" /> 
<mapID target="item004" url = 

"argument2/item004.html" /> 
<mapID target="item005" url = 

"argument2/item005.html" /> 
<mapID target="item006" url = 

"argument2/item006.html" /> 
</map> 

Il documento è di palese interpretazione. Ad esem- 
pio al file "sectionOOl/itemOOl. html" è stato assegna- 
to il nome "itemOOl ". 



DEFINIRE LA TOC 

TOC è l'acronimo di Table ofContent È una struttu- 
ra che elenca tutti gli argomenti inseriti nell'help e 
permette un accesso rapido ad essi mediante un 
menu ad albero. Per definire la TOC create il file 
"my_toc.xml". Anche in questo caso il nome del file è 
opzionale. Digitate il seguente contenuto: 

<?xml version = '1.0' encoding = 'UTF8' ?> 
<!DOCTYPE toc PUBLIC "-//Sun Microsystems Inc. 



//DTD JavaHelp TOC Version 2.0 //EN" "http: 
//java. sun.com/products/javahelp /toc_2_0.dtd"> 


<toc version="2.0"> 


<tocitem text="help"> 


<tocitem text="Section 001 


"> 






<tocitem text= 


"Item 001" 


target= 


'itemOOl" 


/> 


<tocitem text= 


"Item 002" 


target= 


'item002" 


/> 


<tocitem text= 


"Item 003' 


target= 


"item003' 


/> 


</tocitem> 


<tocitem text="Section 002 


"> 






<tocitem text= 


"Item 004" 


target= 


"item004 


'/> 


<tocitem text= 


"Item 005" 


target= 


"item005 


'/> 


<tocitem text= 


"Item 006" 


target= 


"item006 


'/> 


</tocitem> 


</tocitem> 


</toc> 



Il file è di semplice comprensione. L'elemento 
esterno "toc" definisce l'inizio e la fine del tavola 
dei contenuti. Ogni elemento della toc è definito da 
un elemento "tocitem ". Un tocitem può contenere 
al suo interno un qualsiasi numero di tocitem. 
Questo permette di rappresentare una qualsiasi 
struttura ad albero, ramificata a piacere. Quando 
l'elemento tocitem presenta l'attributo target, la fi- 
nestra di help farà sì che cliccando sull'elemento 
grafico rappresentante quell'elemento, venga vi- 
sualizzata la pagina il cui nome è quello specifica- 
to nell'attributo target dell'elemento tocitem. Ad 
esempio, con la toc che abbiamo usato come 
esempio, il nodo principale dell'albero sarà defini- 
to dall'etichetta "help". Cliccandolo si apriranno 
due sottonodi, rispettivamente indicati dalle eti- 
chette "Section 001 " e "Section 002". Aprendo il pri- 
mo, saranno visualizzati altri tre nodi, "Item 001 ", 
"Item 002" ed "Item 003". Cliccando ad esempio 
"Item 002", il sistema di help preleva l'attributo tar- 
get del tocitem pari a "item002". Attraverso il file 






I TUOI APPUNTI 



Functionl 

Lorem ipsum dolor sit arnet, consectetuer adi] Pellentesque 

leo augue, pulvinar non, imperdiet eu, laoreet i sque cursus, 

enimsit arnet posuere condimentum, dolor purus gravida seni, vel 
facilisis pecle arcu eu rubli. Pellentesque liabitant morbi tristique 
senectus et nei us et malesuada fames ac turpis egestas Nam quarn 
nulla, convallis quis, dicturnid malesuada ut leo Duis dui purus, 
scelensque a, nonummy at, varius eu, sapien Curabitur elernentuiTi, 
rubli vel pharetra ultricies, esi leo placerat massa, in heiicìrerit dolor mi 
ac lorem. Quisque non elit in dolor faucibus posuere. Suspendisse 
potenti. Mani augue. Secl sodales neque vitae massa. Aenean 
coiidimentum Curri sociis natoque penatibus et magnis dis partunent 
montes, nascetur ndiculus mus. Proin auctor, ligula a mattis 
nonummy urna eros sagittis magna at dapibus est neque seci rubli. 
Pellentesque ante cliarn, pellentesque lobortis, tristique secl, pìiaretra 
vel, sapien. Praesent sapien. Nulla nisl nulla, placerat vel, lobortis eget, 
placerat eget. leo Maecenas pellentesque, ante eu eleifend accurnsan, 
est rubli hendrent ligula, ut piacerai augue niauns non dolor. Integer 
turpis eros, consequat ac, egestas in, suscipit id, magna. 

Function2 

Lorern ipsum dolor sit arnet consectetuer adipiscing elit Pellentesque 
leo augue, pulvinar non, imperdiet eu, laoreet in, est. Quisque cursus, 

-imi li Hill-i ju ui-ri-i ii i lurii-iili t i iliilm jujiin _r r-i 1 h ,-iu "i-I 

jrcu eu nibh. Pellente: ut morbi tristique 

senectus et netus ei malesuada fames ac turpis egestas. Mani quarn 
nulla, convallis quis, dicturnid, malesuada ut, leo. Duis dui purus, 
scelensque a, nonummy at, varius eu, sapien. Curabitur elementum, 

rubli vel oliaretra ultricies est leo placerat massa, in liendrent dolor mi 



Fig.l: Un esempio di come abbiamo strutturato il file di help 
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map il sistema preleva il file corrispondente al 
nome "item002" che è argumentl Iitem002.html e 
lo visualizza. 



COMBINARE IL TUTTO 
ini Ul\l HELP 

Questa struttura non ci servirà a niente se non riu- 
niamo tutto insieme per farne un Help completo. 
Abbiamo bisogno ancora di un file XML con esten- 
sione ".hs" che definirà l'help set. In questo file sono 
inclusi i riferimenti al file Map e a tutti i file accesso- 
ri da utilizzare. L'esempio seguente mostra il file 
myjielpset.hs, che definisce questo primo esempio 
di help. 

<?xml version='1.0' encoding = 'ISO-8859-l' ?> 

<!DOCTYPE helpset 

PUBLIC "-//Sun Microsystems Inc.//DTD JavaHelp 

HelpSet Version 1.Q//EN" 

"http://java.sun.com/products/javahelp 

/helpset_l_Q.dtd"> 

<helpset version="1.0"> 

Il primo elemento "title" assegna un nome all'help 
che verrà visualizzato nella finestra dell' help. 

<title>Java Help Demo</title> 

L'elemento maps serve a specificare quali sono le 
mappe che definiscono i nomi dei documenti utiliz- 
zati dal sistema di help. Inseriamo in questo ele- 
mento il nome del file da noi creato. 



VISUALIZZARE L'HELP 

Per visualizzare l'help appena costruito utilizziamo 
una classe di utility fornita con Java Help. Portatevi 
nella cartella dove avete decompresso lo zip scarica- 
to dal sito Sun e lanciate il seguente jar. 

jh2.0\demos\bin\hsviewer.jar 

Si aprirà una finestra che vi chiederà di aprire un file 
.hs di definizione dell'helpset. Cliccate su "browse"e 
navigate nel filesystem fino a selezionare il file my_ 
helpseths appena creato. Vi si aprirà una finestra in 
cui potrete navigare e verificare il funzionamento 
dell'help appena creato. 



INCLUDERE L'HELP 
IN UN'APPLICAZIONE 

Ovviamente un help indipendente da un'applica- 
zione ha un'utilità limitata. Vediamo ora come sia 
possibile aggiungere alle nostre applicazioni Java 
stand alone l'accesso ad un help realizzato con Java- 
Help. L'applicazione consisterà in un'applicazione 
swing stand alone con una menu bar con una voce 
che avrà come unico compito quello di visualizzare 
l'help appena costruito. La nostra applicazione di- 
mostrativa è costituita da una semplice classe costi- 
tuita da un unico Jframe. Estendiamo quindi questa 
classe. In più la classe Help che stiamo scrivendo 
implementa anche l'interfaccia ActionListener in 
modo da poter gestire l'unica voce di menu prevista 
e attivare in quel momento l'help. 



<maps> 



<homeID>intro</homeID> 



<mapref location="my_map.jhm"/> 
</maps> 

Il file definisce una vista per ogni struttura d'acces- 
so. Ad esempio il seguente caso mostra come confi- 
gurare la vista per la TOC. Sostanzialmente si confi- 
gura l'help in modo che la TOC venga visualizzata 
attraverso la classe javax.help. UiteAppendMerge for- 
nita con Java Help 

<view mergetype="javax.help.UniteAppendMerge"> 

<name>TOC</name> 

<label>Table Of Contents</label> 

<type>javax.help.TOCView</type> 

<data>my_toc.xml</data> 
</view> 

Il file termina ovviamente con le chiusure dei tag 
ancora aperti. 

</helpset> 
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Fig.2: hsviewer ci chiede di selezionare il file di help 
da visualizzare 

La prima sezione della classe importa il package ja- 
vax.help, le cui classi sono contenute nel file jar che 
accompagna la distribuzione di JavaHelp. 

package it.ioprogrammo; 

import java.awt.event.*; 

import java. net. URL; 

import javax.help.*; 

import javax. swing.*; 

public class Help extends JFrame implements 

ActionListener { 

Scriviamo un metodo buildMenuBarQ che si occu- 
perà della creazione della barra di menu. Il procedi- 
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mento è abbastanza lineare. Viene creato un oggetto 
Build di classe JMenuBar e che rappresenta la nostra 
barra. Viene creato un oggetto helpMenu di classe 
JMenu che rappresenta un menu, infine il menu vie- 
ne associato alla barra tramite il metodo Add. Non ci 
resta che aggiungere delle voci al menu tramite un 
Helpltem di classe JMenuItem. Si noti che a quest'ul- 
timo, il cui riferimento è contenuto nella variabile 
helpltem, viene associato come action listener l'i- 
stanza stessa. Questo ci permetterà di gestire sem- 
plicemente la visualizzazione dell'help senza ricor- 
rere a inner class varie. 

private JMenuBar buildMenuBar() { 
JMenuBar built = new JMenuBar(); 
JMenu helpMenu = new JMenuQ; 



helpMenu. setText("Help"); 



built.add(helpMenu); 



helpltem = new JMenuItemQ; 



helpltem. setText("Show"); 



helpltem. addActionl_istener((Actionl_istener) this); 



helpMenu. add(helpltem); 



return built; 



} 



Il metodo di costruzione del menu viene richiamato 
all'interno del costruttore. In questo modo ogni ap- 
plicazione istanziata avrà automaticamente costrui- 
to il menu. Vengono anche impostati il tiolo della fi- 
nestra e le relative dimensioni tramite i metodi setTi- 
tleO e setSizeO. 

HelpQ { 

super(); 

this.setTitle("Using JavaHelp"); 

this.setSize(300, 300); 

this.setJMenuBar(buildMenuBar()); 



con i dati appena trovati. Ciò si ottiene con il co- 
struttore HelpSetQ a cui vengono passati il classloa- 
der e l'URL. JHelp è sostanzialmente un componen- 
te che mostra un HelpSet e può essere visualizzato 
all'interno di un Pane. Istanziamo quindi il JHelp 
passandogli il riferimento all' HelpSet da visualiz- 
zare, ottenendo così finalmente un riferimento al 
visualizzatore del help. I passi seguenti sono abba- 
stanza comuni in ogni applicazione che faccia uso di 
swing. Costruiamo una nuova finestra e impostia- 
mone il content pane con il riferimento al visualizza- 
tore di help appena ottenuto e impostiamone la 
proprietà vìsibel a true in modo da farla apparire. 

public void actionPerformed(ActionEvent e) { 
if (e.getSource().equals(helpItem)) { 
JHelp helpViewer = nuli; 

try{ 

ClassLoader ci = 

this.getClass().getClassl_oader(); 
URL uri = HelpSet.findHelpSet( 

ci, "it/ioprogrammo/my_helpset.hs"); 
helpViewer = new JHelp(new HelpSet(cl, uri)); 



} catch (Exception el) { 



el . printStackTraceQ ; } 



JFrame frame = new JFrameQ; 



frame.setSize(500, 500); 



frame. getContentPane().add(helpViewer); 
frame. setDefaultCloseOperation( 

JFrame. DISPOSE_ON_CLOSE); 



frame. setVisible(true);} 



} 



Realizziamo ora un semplice metodo mainO in mo- 
do da rendere la classe utilzzabile come programma 
stand alone. Di seguito il codice del metodo mairi. 
Come possibile vedere il metodo si limita ad istan- 
ziare una finestra Help e a renderla visibile tramite il 
metodo setVisibleQ. 




COMPILARE 
E LANCIARE 
L'APPLICAZIONE 

Si compili l'applicazione 
avendo cura di aggiun- 
gere al CLASSPATH le 
librerie proprie di Ja- 
vaHelp jh.jar, j ha II. jan 
jhbasic.jar, jsearch.jar 
presenti nella sottocar- 
tella Ijavahelpllìb della 
directory nella quale 
avete scelto di scompat- 
tare il file .zip. 
Anche per lanciare l'ap- 
plicazione è necessario 
avere cura di includere 
le suddette librerie nel 
CLASSPATH. 



VISUALIZZARE L'HELP 

Veniamo al metodo centrale della classe, quello per 
la visualizzazione dell'help. Il metodo in cui attivia- 
mo la visualizzazione è actionPerformedO poiché 
questo viene richiamato ogni volta che l'utente clic- 
ca sulla voce di menu. Viene dichiarato un oggetto di 
tipo JHelp. Questa classe, fornita con JavaHelp, per- 
mette di visualizzare un help a partire dalla defini- 
zione contenuta nel file .hs. Come prima cosa si ot- 
tiene il ClassLoader della nostra applicazione di 
esempio. Poi serve l'URL dell'HelpSet creato nei 
passi precedenti. Per trovarlo si utilizza il metodo 
statico di utilità JìndHelpSet della classe HelpSet. 
Questo metodo controlla se il ClassLoader passatogli 
è in grado di trovare la risorsa con il percorso speci- 
ficato, e in caso affermativo lo restituisce. Se tutto ha 
funzionato possiamo istanziare un nuovo HelpSet 



public static void main(String[] args) { 
Help window = new Help(); 
window.setVisible(true); 



CONCLUSIONI 

L'articolo ha mostrato come utilizzare JavaHelp per 
realizzare un semplice sistema di help e come inne- 
starlo all'interno delle nostre applicazioni. Le poten- 
zialità di JavaHelp sono tuttavia maggiori. Ad esem- 
pio oltre alla TOC è possibile aggiungere al help una 
struttura ad indice, un glossario ed anche una ricer- 
ca testuale con indicazione di un ranking per la pa- 
gina proposta. Insomma è possibile creare un help 
professionale. 

Daniele De Michelis 
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WINDOWS WORKFLOW 



FOUNDATION 



OGNI APPLICAZIONE, PICCOLA O GRANDE CHE SIA, IMPLEMENTA UN WORKFLOW. 

IN QUESTO ARTICOLO SCOPRIREMO COME CREARE WORKFLOW, ANCHE COMPLESSI, CON 

LA NUOVA TECNOLOGIA MICROSOFT NATA PER GESTIRE FACILMENTE I FLUSSI 





UCDG WEB 

ArticoloWorkflow.zip 



n 




REQUISITI 



■AI.I.WmiW.IU4^ 
i Basi di 
programmazione C# 



à 



Visual Studio 2005 (o 
versione Express), 
WinFXRTQ Windows 
SDK, Development 
Tools per WinFX, Visual 
Studio 2005 Extensions 
per Windows 
Workflow Foundation 




Prima di addentrarci nella tecnologia Win- 
dows Workflow Foundation, è bene capire 
cosa è un workflow partendo dalla sua defi- 
nizione. Un workflow è la formale, ma sintetica, de- 
scrizione di un processo costituito da una serie di 
task (attività elementari), eventualmente cicliche o 
alternative, da eseguire per ottenere un preciso ri- 
sultato. Il concetto è abbastanza semplice se calato 
in un contesto reale e magari quotidiano: per navi- 
gare su internet dobbiamo: 

1. accendere il PC; 

2. attendere che il sistema operativo si carichi; 

3. eseguire il logon; 

4. se il logon ha esito positivo dobbiamo avviare la 
connessione; 

5. aprire il browser; 

6. digitare Furi. 

I sei passaggi appena elencati sono, a tutti gli effetti, 
"una sequenza di task elementari da eseguire per 
ottenere un preciso risultato". Un Workflow insom- 
ma! È facile immaginare che, in ambito software, si 
sia continuamente circondati da workflow sia sem- 
plici sia decisamente complessi. Si provi ad esempio 
ad immaginare un sito web di e- commerce. Sono 
decine, se non centinaia, i workflow che governano 
le attività di un sito web di tale tipo. Workflow che, 
consapevolmente o meno, abbiamo già implemen- 
tato. Proviamo ad immaginare il workflow che con- 
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Fig. 1: 1 template di Visual Studio 2005 per Workflow 



duce all'ordine di un prodotto: uno dei task potreb- 
be essere la selezione della merce da acquistare (un 
task ciclico), un altro la scelta dell'indirizzo di spedi- 
zione, un altro ancora il pagamento dell'importo 
dovuto etc Task che, come ad esempio quello relati- 
vo al pagamento, possono al loro interno contenere 
interi workflow! Compreso il concetto di Workflow, 
vediamo cosa ci propone Microsoft con Windows 
Workflow Foundation. 



WINDOWS WORKFLOW 
FOUNDATION 

L'idea è molto semplice, ovvero quella di fornire 
all'utente una serie di strumenti per disegnare grafi- 
camente il "workflow" di un'applicazione. La rivolu- 
zione sta nel fatto che automaticamente in perfetta 
corrispondenza al disegno verrà generato il codice 
che consente al programmatore di implementare un 
task. Windows Workflow Foundation è un frame- 
work per lo sviluppo di workflow in ambiente Win- 
dows. È costituito sia da API sia di tool integrati in 
Visual Studio 2005 per lo sviluppo e l'esecuzione di 
applicazioni basate su Workflow. Sin dalla versione 
2003 di Visual Studio infatti, Microsoft ha portato 
avanti la formula dell'ambiente unico di sviluppo. 
Workflow Foundation non fa eccezione, a tutto 
vantaggio della produttività. Esattamente come ac- 
cade nello sviluppo tradizionale quando si crea 
un'applicazione in modo visuale e la logica applica- 
tiva risiede nel code behind, così un workflow viene 
letteralmente "disegnato" in Visual Studio 2005, tra- 
scinando i task direttamente nel designer, mentre la 
logica risiede in classi separate. Un workflow così 
creato ha la possibilità di essere usato sia su applica- 
zioni client sia su applicazioni server, Windows 
forms o asp.net ed in tutte i tipi di applicazioni .net 
(managed). In Visual Studio 2005, abbiamo a dispo- 
sizione una serie di template per la realizzazione 
delle diverse tipologie di workflow (Figura 1): 

• Sequential Workflow Console Application: 

crea un progetto che contiene un workflow se- 
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quenziale ed un'applicazione console di test. 
Sequential Workflow Library: crea un proget- 
to che contiene un Workflow sequenziale. 
Workflow Activity Library: crea un progetto 
per la creazione di attività (task) da poter utiliz- 
zare in altri progetti workflow. 
State Machine Console Application: crea un 
progetto per la realizzazione di una macchina a 
stati e la relativa console di test. 
State Machine Workflow Library: crea un pro- 
getto State Machine. 

Empty Workflow: crea un progetto workflow 
vuoto. 



I link per il download di tutto il materiale sono ripor- 
tati nei box laterali. Una volta installato il tutto, sia- 
mo pronti per creare i nostri Workflow 



IL MOSTRO PRIMO 
WORKFLOW 

Per iniziare a prendere un po' di dimestichezza con 
Windows Workflow Foundation, creiamo il nostro 
primo, semplice, workflow come schematizzato in 
Figura 2. 
Inizieremo creandolo per la console di test. 




Come si evince dall'elenco, Visual Studio 2005 sup- 
porta 2 diverse tipologie di Workflow: quello sequen- 
ziale e la macchina a stati. Un workflow sequenzia- 
le è caratterizzato da una serie di task in sequenza 
appunto, ovvero quando il task precedente è termi- 
nato inizia il successivo. Sebbene sia di tipo sequen- 
ziale, questo workflow può ricevere degli input 
esterni che, in sostanza, potrebbero modificare l'ori- 
ginale ordine di esecuzione. Una macchina a stati 
invece è costituita da una serie di "stati", uno dei 
quali sarà lo stato iniziale ed un altro quello finale 
che denota il completamento del workflow. Dopo 
aver compreso questi concetti, passiamo subito alla 
realizzazione del nostro primo Workflow. 



COSA CI SERVE 

PER CREARE WORKFLOW 

Sviluppare workflow oggi, con Windows Workflow 
Foundation, non è immediato. La piattaforma su 
cui tutto il sistema si basa è ancora in beta e gli stru- 
menti di sviluppo non sono ancora completi. Ci toc- 
ca quindi scaricare ed installare manualmente di- 
versi componenti. La prima operazione da fare, se 
abbiamo versioni beta di Visual Studio 2005 installa- 
te sul nostro PC, è toglierle. I tool per lo sviluppo di 
Workflow funzionato solo sulla versione finale di 
Visual Studio 2005 o sulle versioni Express (sempre 
finali). Per rimuovere correttamente tutti i compo- 
nenti in beta, ci viene in aiuto un comodo tool (vedi 
box laterale). Una volta avviato, sarà lui a seleziona- 
re tutti i componenti in beta da rimuovere dalla no- 
stra macchina di sviluppo in modo che essa sia 
pronta all'installazione dei componenti definitivi ed 
alle estensioni di WinFX. Una volta installata la ver- 
sione finale di uno dei tool di sviluppo, è necessario 
scaricare ed installare, nell'ordine: 

1 . il runtime di WinFX; 

2. il Windows SDK; 

3. i Development Tools per WinFX; 

4. le estensioni di Workflow Foundation per Vi- 
sual Studio 2005. 
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Rg. 2: II Workflow completo che realizzeremo 

ILa prima operazione da svolgere è quella di sele- 
zionare il tipo di Workflow che vogliamo realizza- 
re. Apriamo quindi Visual Studio 2005 e selezionia- 
mo File/New Project. Dalla finestra visibile in figura, 
selezioniamo la voce "Sequential Workflow Conso- 
le Application" , scegliamo un nome per l'applica- 
zione e specifichiamo un percorso in cui salvarla. 
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DOWNLOAD 

Per scaricare tutto 
l'occorrete per 
sviluppare Workflow, 
accedere alla pagina 



http://msdn.microsoft.com 
/windowsvista/getthebeta 
/default.aspx 

e scaricare l'occorrente. 
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Uno dei siti di 

riferimento relativo a 

Windows Workflow 

Foundation è 



http://www.windowswork 
flow.net/ 

ricco di esempi e 

activity pronte da 

scaricare. 



2 Completato il primo passo, ci troveremo d'avan- 
ti un workflow vuoto in cui possiamo inserire i 
nostri elementi (Activity) trascinandoli dalla Tool- 
box di sinistra. Come è possibile vedere in figura, ab- 
biamo diversi tipi di Activity tra cui possiamo sce- 
gliere. Per questo primo esempio, scegliamo quella 
denominata "Code Activity" e trasciniamola sul 
workflow vuoto. Ripetiamo lo stesso passaggio una 
seconda volta per creare 2 activity diverse. Il risulta- 
to deve essere simile a quello in figura. 




311 nostro Workflow contiene ora 2 task da ese- 
guire denominati codeActivity_l e codeActivi- 
ty_2. Sta a noi ora implementare il codice che defi- 
nisce il comportamento di questi 2 task. Per farlo, è 
sufficiente fare un doppio clic su ogni activity per 
definirne il comportamento in corrispondenza del- 
l'evento codeActivityX_ExecuteCode. Da notare la 
somiglianza che c'è, a livello di utilizzo dell'editor, 
con la definizione del comportamento di un pulsan- 
te! Definiamo quindi prima una variabile privata di 
tipo stringa che chiameremo Name che valorizzere- 
mo con l'input dell'utente. Tale variabile sarà poi 
utilizzata da codeActivity_2 quando verrà eseguita, 
ovvero al completamento della codeActivity_l. 

public sealed partial class Workflowl: 

SequentiaIWorkflowActivity 
{ private string Name; 

/// <summary> 

/// Costruttore della classe Workflowl 



/// </summary> 



public Workflowl (){ 



InitializeComponentO; } 



/// <summary> 



/// Esecuzione della prima Activity 



/// </summary> 



/// <param name="sender"x/param> 



/// <param name="e"x/param> 



private void codeActivityl_ExecuteCode( 

object sender, EventArgs e ) { 
Console. Writel_ine( "****** Questo è il primo 
Workflow ******\ r \ n " ); 



Console. Write( "Digita il tuo nome: " ); 
Name = Console. ReadLine();> 
/// <summary> 



/// Esecuzione della seconda Activity 

/// </summary> 

/// <param name="sender"x/param> 



/// <param name="e"x/param> 



private void codeActivity2_ExecuteCode( object 

sender, EventArgs e ) { 
Console. Writel_ine( "Benvenuto in Workflow 

{0}", Name ); } 



} 



4 Compiliamo e mandiamo in esecuzione il nostro 
progetto. Trattandosi di un "Sequential Work- 
flow Console Application", vedremo apparire a vi- 
deo una console che ci chiederà di inserire il nostro 
nome. È stato eseguito il primo blocco (codeActivi- 
ty_l). Una volta fatto, premendo il tasto invio, ci tro- 
veremo il saluto personalizzato, dato dall'esecuzio- 
ne del secondo blocco (codeActivity_2). 
Il nostro primo workflow è stato eseguito corretta- 
mente. 




L'esempio, per quanto semplice ci dà la misura di 
quanto sia immediato implementare un semplice 
workflow sequenziale. L'aver scelto di usare un pro- 
getto di tipo Sequential Workflow Console Appli- 
cation ci aiuta notevolmente implementando già le 
istruzioni per avviare il workflow ed attenderne il ri- 
sultato. 

Se, in Visual Studio 2005, apriamo il file Program.cs 
vedremo il seguente codice: 

namespace SimpleWorkflowl 
{ class Program 

{ static void Main(string[] args) 

{ WorkflowRuntime workflowRuntime = new 

WorkflowRuntime(); 
AutoResetEvent waitHandle = new 

AutoResetEvent(false); 
workflowRuntime. WorkflowCompleted + = 

delegate(object sender, 
WorkflowCompletedEventArgs e) 

{waitHandle.SetQ;}; 

workflowRuntime. WorkflowTerminated + = 

delegate(object sender, 
WorkflowTerminatedEventArgs e) 
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{ Console.WriteLine(e.Exception.Message); 

waitHandle.Set(); }; 
Workflowlnstance instance = 

workflowRuntime.CreateWorkflow( 
typeof(SimpleWorkflowl.Workflowl)); 
instance. Sta rt(); 



waitHandle.WaitOne(); } } 



> 



Come prima istruzione troviamo quella relativa all'i- 
stanza del WorkflowRuntime che rappresenta ap- 
punto in runtime in cui "vive" il nostro Workflow. 
Segue quindi la creazione di waitHandle di tipo Au- 
toResetEvent il cui scopo è quello di mantenere il 
thread in attesa finché non interviene un evento che 
porta il thread nello stato di "signaled" tramite la 
chiamata waitHandle. SetQ- Subito dopo vengono 
creati due delegate per la notifica del completamen- 
to e della "terminazione" del Workflow. Come è evi- 
dente dal codice, la differenza tra lo stato di "Work- 
flowCompleted" e quello di "WorkflowTermina- 
ted" è che nel primo caso il workflow è terminato 
correttamente (lo stato del thread passa in signaled 
attraverso waitHandle. Set (), mentre nel secondo il 
Workflow è terminato per un errore. Abbiamo tutti 
gli elementi per usare il Workflow appena creato 
quindi, ne recuperiamo una istanza com workflow- 
Runtime. CreateWorkflowC J è la facciamo par- 
tire con instance. Start (). Per finire, waitHandle. 
WaitOneQ mette il thread in attesa di ricevere un 
segnale. Il nostro Workflow è partito ed è pronto per 
eseguire la prima activity. 



UN WORKFLOW 
PIÙ COMPLESSO 

Nell'esempio fatto in precedenza, abbiamo creato 
un semplice workflow sequenziale con 2 "activity" il 
cui scopo era semplicemente quello di chiederci il 
nome e rispondere con un saluto personalizzato. Il 
tipo di Workflow scelto conteneva già una console di 
test. Vedremo ora un workflow leggermente più 
complesso utile a comprendere meglio le potenzia- 
lità di questo strumento. Per testarlo useremo un 
client Windows rendendo l'esempio più simile alla 
realtà. A titolo di esempio realizzeremo un Workflow 
utile all'archiviazione di un documento in funzione 
della sua tipologia (fattura, rimborso spese età). In 
un caso particolare, andremo anche a valutare una 
condizione specifica e chiedere una approvazione. 
Essendo un esempio ed esulando dallo scopo di 
questo articolo, non è implementata la logica di ar- 
chiviazione del documento. Una volta compreso il 
meccanismo del workflow, sarà semplice inserirla in 
un secondo momento. Come abbiamo fatto per il 
Workflow precedente, apriamo il nostro Visual Stu- 
dio 2005 e creiamo due nuovi progetti: il primo sarà 



il nostro workflow mentre il secondo rappresenterà 
il client di test. 

Come prima cosa, nel progetto Workflow, creiamo 
una serie di membri che rappresenteranno il nostro 
documento. Tali membri saranno privati ed esposti 
attraverso delle proprietà pubbliche: 

private string _DocumentType; 
private string _DocumentTitle; 
private string _DocumentOwner; 



private int _ExpensesAmount; 



public bool Approved; 



public string DocumentType { 



get { return _DocumentType; } 



set { _DocumentType = value; } } 



public string DocumentTitle { 



get { return _DocumentTitle; } 



set { _DocumentTitle = value; }} 



public string DocumentOwner { 



get { return _DocumentOwner; } 



set { _DocumentOwner = value; } } 



public int ExpensesAmount { 



get { return _ExpensesAmount; } 



set { _ExpensesAmount = value; } 



} 



Nel progetto Workflow, trasciniamo la prima activity 
chiamandola ProcessInputData il cui scopo reale 
sarà quello di effettuare una valutazione dei dati ri- 
cevuti prima di procedere con il workflow. Nel no- 
stro caso specifico, restituirà solo un messaggio al- 
l'utente a conferma della ricezione dei dati: 

private void ProcessInputData_ExecuteCode( object 

sender, EventArgs e ) { 
MessageBox.Show( "Dati ricevuti. Inizio il 

workflow" ); 
} 

Aggiungiamo ora un nuovo tipo di activity al no- 
stro workflow di tipo IfElse. È facile immaginare 
che lo scopo di questa particolare activity è quello 
di valutare una condizione If e scegliere di conse- 
guenza il ramo del workflow corretto. Nel nostro 
caso, la nostra scelta sarà sul tipo di documento 
ricevuto. Se si tratta di una richiesta di rimborso 
spese (Expenses), verrà seguito un ramo che, in 
funzione dell'ammontare della richiesta, richiede 
una approvazione o meno. Diversamente verrà se- 
guito il secondo ramo. 

Per settare la condizione dell' activity IfElse sele- 
zioniamo uno dei due rami e, dalla finestra delle 
proprietà, alla voce Condition, selezioniamo la 
voce System. Workflow. Activities.Rules. RuleCon- 
ditionReference. Diamo innanzitutto un nome 
alla nostra "condizione" e, selezionando la voce 
Expression, apriamo l'editor delle condizioni che 
ci permette di scrivere la condizione da valutare 




Il tool di rimozione 
delle versioni beta di 
Visual Studio 2005 è 
scaricabile da qui: 



http://lab.msdn.microsoft. 
com/vs2005/un insta II 
/preRTMuninstall/default 
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L'autore può essere 
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suo blog all'indirizzo 

http://bl ogs. m i ndbox. iti 

mighell e sarà lieto di 
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Edit constraints to create a mie condition. 
Example: this.Propl == *Yes r || this.PropZ = 



2oz..--e-: .oe == -xos-ìeì \ 
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Fig. 3: L'editor per la selezione delle condizioni della 
activity IfElse 

nel nostro If Procediamo aggiungendo le varie ac- 
tivity ed impostando le relative condizioni come 
mostrato in Figura 3 completando così il nostro 
workflow. 

Non ci resta che realizzare il nostro client per "con- 
sumare" il workflow 

Apriamo il formi del relativo progetto ed inseria- 
mo gli elementi come in Figura 4: 
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Fig. 4: Il forni per l'utilizzo del nostro workflow 

Non ci resta ora che inserire gli elementi utili ad 
avviare ed usare il workflow Come prima cosa, ab- 
biamo la necessità di aggiungere tutti i riferimenti 
utili al runtime di Windows Workflow Foundation. 
Cliccando con il tasto destro del mouse sulla car- 
tella "References" del nostro progetto, aggiungia- 
mo i seguenti componenti: System. Workflow. Acti- 
vities, System. Workflow. ComponentModel, Sy- 
stem. Workflow. Runtime e naturalmente il riferi- 
mento al nostro workflow nell'esempio chiamato 
DocumentProcess. 

La prima operazione da fare nel nostro form è 
quella istanziare ed avviare il runtime di Workflow 
Foundation: 

WorkflowRuntime _wfRuntime; 
Workflowlnstance _wflnstance; 

public Forml() 

{ 

InitializeComponentO; 

_wfRuntime = new WorkflowRuntime(); 

_wf Runtime. Sta rtRuntime(); 

y~ 

Ora che abbiamo tutti i riferimenti, non ci resta 
che avviare il workflow passando i relativi parame- 
tri ed attenderne l'esecuzione. Per farlo, inseriamo 



il seguente codice nell'evento click del bottone: 

private void btnStartWorkFlow_Click( object sender, 

EventArgs e ) { 
Dictionary<string, object> parameters = new 

Dictionary<string, object>(); 
parameters. Add( "DocumentType", 

cmbDocumentType.Selectedltem.ToStringO ); 
parameters. Add( "DocumentTitle", 

tbxDocumentTitle.Text ); 
parameters. Add( "DocumentOwner", 

tbxDocumentOwner.Text ); 
parameters. Add( "ExpensesAmount", 

int.Parse(tbxExpensesAmount.Text)); 

_wflnstance = _wfRuntime.CreateWorkflow( 

typeof( Workflowl ), parameters ); 
_wfInstance.Start(); 
T~ 

Il Workflow partirà usando i parametri passati e se- 
guirà il flusso che abbiamo creato. Il risultato sarà 
il seguente: 




Fig. 5: Il workflow eseguito 



CONCLUSIONI 

In questo numero abbiamo trattato solo una pic- 
cola parte di Windows Workflow Foundation, ma 
già si capisce quanto sia potente e comoda questa 
tecnologia. La possibilità di creare delle custom 
activity, di ho stare il Workflow come servizio web, 
di richiamare altri workflow con Y activity Invoke- 
Workflow etc, rendono questo strumento estre- 
mamente flessibile e versatile per ogni tipo di esi- 
genza. Per quanto la tecnologia non sia ancora 
matura si intravede già quali saranno i possibi- 
li sviluppi per il futuro, ovvero costruire ambienti 
che semplifichino ulteriormente la vita al pro- 
grammatore "agganciandosi" a quella che è oggi la 
programmazione ad oggetti, sistemi che gestisca- 
no anche la logica di un'applicazione oltre che la 
pura realizzazione. 
Buon workflow. 

Michele Locuratolo 
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CREARE APPLICAZIONI 
SERVICE ORIENTED 

COMUNICAZIONE ED INTEROPERABILITÀ SONO LE PAROLE CHIAVE DEL FUTURO. VEDIAMO 
UNA DELLE SOLUZIONI MICROSOFT: PER LA CREAZIONE DI SOFTWARE CHE FA LARGO USO 
DI SISTEMI DISTRIBUITI: WINDOWS COMMUNICATION FOUNDATION 
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, Conoscenze base di 
programmazione in C# 
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COM+, CORBA, Web Services, MSMQ sono 
alcuni dei sistemi che hanno dominato e at- 
tualmente dominano la scena della Service 
Oriented Architecture (SOA). L'unione delle loro ca- 
ratteristiche consente di rispondere a molte delle 
necessità attuali, ma effettivamente non a tutte e 
non in maniera lineare. Durante gli anni ogni singo- 
la tecnologia è stata pensata e realizzata al nascere 
della relativa esigenza, dando vita ad un miscuglio 
di tecniche ognuna di esse con il proprio paradigma 
di programmazione in cui spesso è difficile distri- 
carsi. Oggi, l'esigenza di unificare e semplificare 
questa forma di sviluppo è stata la molla che ha 
dato vita a Windows Communication Foundation 
(a.k.a. Indigo). 



PERCHE WINDOWS 

COMMUNICATION 

FOUNDATION 

Connettività, applicazioni distribuite e interopera- 
bilità sono i concetti alla base di WCF, un robusto 
framework che consente di creare complesse archi- 
tetture Service Oriented con la semplicità con cui fi- 
no ad ora era possibile scrivere gli XML Web Service. 
Ma quali sono i vantaggi? Perché scegliere il frame- 
work WCF? Fino ad oggi la via intrapresa per lo svi- 
luppo di una logica aziendale era prevalentemente 
costituita dalla scrittura di programmi Object Orien- 
ted, spesso però insufficiente per garantire una ri- 
sposta adeguata alle diverse, crescenti esigenze. 
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In scenari in cui le necessità indirizzano lo sviluppo 
verso la realizzazione di applicazioni distribuite, l'i- 
terazione tra i diversi blocchi di business layer in 
forma di servizi garantisce un approccio decisamen- 
te migliore. Come già accennato, i diversi sistemi at- 
tualmente disponibili sono già in grado di fornire un 
supporto allo sviluppo di servizi, ma costituiscono 
una selva oscura in cui il programmatore deve distri- 
carsi con non poche difficoltà prima di uscirne. 
In Tabella 1 possiamo vedere come WCF rappresen- 
ta la risposta alle diverse esigenze legate allo svilup- 
po Service Oriented. 

Forse la tabella può far sembrare WCF un framework 
chiuso, non aperto verso applicazioni non Micro- 
soft. L'affermazione è semplicemente sbagliata. 
Qualsiasi tecnologia in grado di consumare web ser- 
vices è anche capace di interagire con applicazioni 
scritte con WCF, questo perché il protocollo alla ba- 
se delle comunicazioni è SOAR 
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Fig. 1: II setup di WinFX 



IL PRIMO SERVIZIO 
WINDOWS 
COMMUNICATION 
FOUNDATION 

WCF, che al momento della stesura di questo artico- 
lo è ancora in versione beta, è basato sul .NET Fra- 
mework versione 2.0 ed integrato in Visual Studio 
2005. Attualmente, in riferimento a ciò che erano e 
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sono i Web Services, è possibile ospitare un servizio 
solo su un web server come US o Apache. In .NET 1.0 
e 1.1, è tuttora possibile ottenere una adeguata co- 
municazione interprocesso attraverso l'utilizzo di 
Remoting, una tecnologia che consente di creare un 
server che espone dei servizi consumabili da client 
in esecuzione su application domain o processi, 
consentendo l'esecuzione server anche al di fuori di 
US. Ma se le tecnologie esistono, perché WCF? La 
possibilità di poter usufruire di un framework unico, 
flessibile ed estendibile, la possibilità di scindere il 
servizio dall'host che lo eseguirà, il tutto seguendo 
pochi semplici passi è la risposta alla domanda fat- 
ta. Come vedremo, in WCF un servizio può essere 
ospitato in diversi host: 

• Hosting o self-hosting in applicazioni (Console, 
Windows Forms o Windows Service) 

• Hosting in US. 

In questo articolo proveremo ad utilizzare un ser- 
vizio, in hosting su un'applicazione console ed uti- 
lizzato da un'altra applicazione console. Vedremo 
come, in maniera molto semplice, le due applicazio- 
ni comunicano tra di loro e come è possibile espor- 
re lo stesso servizio anche come web service. Ve- 
diamo un po' di codice: dopo aver installato WinFx, 
il pacchetto contenente Windows Communication 
Foundation, per realizzare il servizio dobbiamo scri- 
vere la nostra classe di servizio. Creiamo il file Rate- 
Service.cs e aggiungiamo il seguente codice: 

using System; 

using System. ServiceModel; 

namespace ioProgrammo.WCF 

{ 

[ServiceContractO] 
public interface IRateService 
{ 

[OperationContract()] 

decimai CalcolaRata(decimal importo, int mesi);} 
[ServiceBehavior()] 
public class RateService : IRateService 

{ 

[OperationBehavior()] 

public decimai CalcolaRata(decimal importo, int mesi) 

{ 

decimai rata = (importo / mesi); 

Console. Writel_ine("Importo: {0}", importo); 

Console. Writel_ine("Mesi: {0}", mesi); 

Console. Writel_ine("Rata: {0}", rata); 

return rata; } } 



Cerchiamo esattamente di capire cosa rappresenta 
questo codice soffermandoci sulla firma dei metodi 
e sugli attributi utilizzati. Con WCF il presupposto 
allo sviluppo dei servizi è la definizione dei contrat- 



ti. Un contratto stabilisce le operazioni che il servi- 
zio espone. Questo viene realizzato mediante la 
creazione di interfacce e classi marcate con attribu- 
ti che ne stabiliscono il comportamento. Nel nostro 
esempio notiamo l'utilizzo dell'attributo Service- 
Contract per la definizione dell'interfaccia e dell'at- 
tributo OperationContractper la definizione dei me- 
todi esposti. La classe che si occupa di implementa- 
re il contratto definito nell'interfaccia, viene invece 
marcata con gli attributi ServiceBehavior e Opera- 
tionBehavior. Questa nuova definizione sostituisce 
quella finora utilizzata per i tradizionali Xml Web 
Services, dove l'attributo WebService definisce le 
caratteristiche della classe di servizi, mentre l'attri- 
buto WebMethod rappresenta i singoli metodi (o ser- 
vizi) esposti e le rispettive impostazioni. 




DELL'ARCHITETTURA SERVICE-ORIENTED 



Le architetture service-oriented 
definiscono quattro concetti detti 
pilastri: 

1. Definizione di confini esplici- 
ti: i limiti entro i quali un servi- 
zio deve muoversi e funzionare 
devono essere ben definiti. È 
importante distinguere 
l'accesso ad oggetti locali 
dall'accesso ad un servizio. 

2. I servizi sono autonomi: ogni 
servizio deve essere capace di 
funzionare senza dipendere da 
altri servizi. 



3. Un servizio condivide schemi 
e contratti e non classi ed 
interfacce: ogni servizio 
accetta uno schema di dati, 
costituendo così architetture 
tra loro disaccoppiate che 
rimangono stabili nel tempo. 

4. Compatibilità dei servizi ba- 
sata su policy: ogni servizio 
deve stabilire esplicite regole 
per il suo utilizzo in forma 
leggibile, in modo da 
consentire la separazione tra il 
servizio e le modalità di accesso 
al servizio. 



UNA CONSOLE 
COME HOSTING 

Dopo aver definito il nostro servizio, creiamo ora 
l'hosting che deve ospitarne l'esecuzione. Creiamo 
un nuovo file Server.cs ed inseriamo il seguente co- 
dice: 

using System; 

using System. ServiceModel; 

namespace ioProgrammo.WCF 

{ 

public class Server 
{ 

public static void Main(string[] args) 
{ 

using (ServiceHost host = new ServiceHost(typeof( 
ioProgrammo.WCF. RateService))) 

{ 
Uri address = new Uri( 

"http://localhost:8QQQ/RateService/"); 

host.AddEndpoint( 

typeof(ioProgrammo.WCF.IRateService), 




GLOSSARIO 



SOAP (SIMPLE 
OBJECT ACCESS 
PROTOCOL) 

Protocollo per lo 
scambio di dati tra 
diverse applicazioni. 



EMDPOIMT 

Indica uno specifico 
punto di accesso 
di un Web Service 
utilizzando un tipo 
di dati e un 
determinato 
protocollo. 
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new WSHttpBindingO, address); 



{ 



host.Open(); 



Console. Writel_ine("Service Started."); 



Console. ReadLine(); 



Console. Writel_ine("Service Stopped!!!"); 



host.Close(); } } } 



> 



Come potete notare gran parte del lavoro è svolto 
dalla classe ServiceHost che, dopo aver dichiarato 
l'endpoint, apre la connessione e si mette in attesa 
di chiamate in ingresso. Il funzionamento dell'host 
ha luogo mediante la creazione di uno o più end- 
points ognuno dei quali imposta un contratto da 
utilizzare, la modalità di comunicazione con il servi- 
zio e un indirizzo che indica dove è possibile contat- 
tare l'endpoint. Nell'esempio il contratto è costituito 
dall'interfaccia IRateService marcata con l'attributo 
ServiceContract, il tipo di comunicazione utilizzata 
dall' endpoint, definita dall'oggetto WSHttpBinding, 
ed infine l'indirizzo da raggiungere per poter esegui- 
re il servizio. 



L'ABC DI WINDOWS COMMUNICATION 
FOUNDATION 



tre elementi chiave di un endpoint 
che chiariscono il suo significato co- 
stituiscono V ABC di WCF: 

• Address: indica l'indirizzo del 
servizio sotto forma di Uri. 
Esempio: http://localhost:8000 
/MyService oppure soap://localhost: 
8000/MyService 

• Binding: stabilisce le modalità 
di comunicazione con il servizio. 
Esso è l'insieme delle informa- 



zioni che controllano il traspor- 
to, il protocollo e la codifica uti- 
lizzata per comunicare con V end- 
point. 
• Contract: è la definizione di ciò 
che il servizio fa, specificandone 
le operazioni e i messaggi. 

Tutti i tre elementi sono presenti 
nel WSDL nei tag wsdhservice, 
wsdl:binding, wsdl:portType e 
wsdhmessage. 
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Nell'esempio viene utilizzato l'http come protocollo 
di trasporto, ma WCF consente l'uso anche di altri 
protocolli come tcp o udp, modificando semplice- 
mente il prefisso dell'uri ed il relativo tipo di bin- 
ding. Se, ad esempio, volessimo utilizzare un canale 
tcp, è sufficiente sostituire nettcp://localhost:8000 
IRateService/ all'indirizzo indicato ed impostare il 
tipo di binding attraverso l'oggetto NetTcpBinding. 
È anche possibile creare dei binding personalizzati 
attraverso l'oggetto CustomBinding. Nel nostro 
esempio, l'utilizzo di WSHttpBinding garantisce l'af- 
fidabilità della comunicazione end-to-end, risultan- 
do però inutilizzabile per le applicazioni che neces- 
sitano delle funzioni di accodamento dei messaggi. 
Proviamo ora a formulare l'ipotesi di un client che 
deve utilizzare il nostro servizio. Creiamo un nuovo 
file Client.cs ed aggiungiamo il seguente codice: 

using System; 

using System. ServiceModel; 

namespace ioProgrammo.WCF 



public class Client 



{ 



public static void Main(string[] args) 



{ 



Uri address = new Uri( 

"http://localhost:8000/ServerCalculator/"); 
ioProgrammo.WCF.IServerCalculator proxy = nuli; 
proxy = ChannelFactory.CreateChannel 

<ioProgrammo.WCF.IServerCalculator> 
(address, new WSHttpBindingO); 



decimai importo, importoRata; 



int mesi; 



Console. Write("Importo: "); 



importo = decimai. Parse(Console.ReadLine()); 



Console. Write("Mesi: "); 



mesi = int.Parse(Console.Readl_ine()); 
importoRata = proxy.CalcolaRata(importo, mesi); 
Console. Writel_ine("ImportoRata: {0}", importoRata); 
}} 
} 



Così come nell'applicazione host, anche nel client 
è necessario definire l'endpoint da raggiungere. 
Perciò nel codice riportato creiamo un canale pas- 
sando l'indirizzo e il tipo di comunicazione da 
attivare, ed utilizziamo le potenzialità dei generics 
per ottenere l'istanza remota del servizio. Infine 
viene effettuata una semplice chiamata al metodo 
CalcolaRata. 

In Figura 2 potete vedere il risultato della comuni- 
cazione tra l'applicazione client e l'applicazione 
server. 




Fig. 2: La comunicazione tra client e server 



SERVE Ul\l HOSTING? 
ECCO US... 

Lo stesso servizio, però, può essere esposto anche 
come web services e quindi ospitato sul web ser- 
ver US. A questo scopo, WCF introduce la nuova 
estensione .svc per identificare un web service e 
distinguerlo dai classici .aspx. La configurazione in 
questo caso viene gestita tutta attraverso il file 
web.config. Creiamo una nuova directory virtuale 
su US ed inseriamo nella relativa cartella un file 
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web.config con il seguente codice: 



<?xml version="1.0"?> 



<configuration xmlns= "http://schemas.microsoft.com 
/.NetConfiguration/v2.0"> 



<system.serviceModel> 



<services> 



type="ioProgrammo.WCF.ServerCalculator"> 



<endpoint 



address= 



binding="wsHttpBinding" 



bindingConfiguration = "Bindingl" 



contract="ioProgrammo 

.WCF.IServerCalculator" /> 



</service> 



</services> 



<bindings> 



<wsHttpBinding> 



<binding 



configurationName="Bindingl"/> 



</wsHttpBinding> 



</bindings> 



</system.serviceModel> 



</configuration> 

Notate che tutto quello fatto nell'applicazione con- 
sole eseguita come hosting del servizio, viene esatta- 
mente replicato nel web.config. Abbiamo semplice- 
mente omesso l'attributo address del tag endpoint 
perché viene utilizzato l'indirizzo esposto da US. 
Dopo la creazione del web.config posizioniamo nel- 
la cartella bin della directory virtuale l'assembly 
contenente il servizio ed infine scriviamo la pagina 
che si occuperà di esporre il nostro web service, la 
chiamiamo WSCalculator.svc e ci inseriamo il se- 
guente codice: 

<%@Service language=C# Debug = "True" class= 

"ioProgrammo.WCF.ServerCalculator" %> 
<%@Assembly Name="assemblyName" %> 

Chi ha lavorato con ASRNET anche nelle versioni 
precedenti noterà una certa familiarità nella sintas- 
si. Infatti la prima direttiva @Service dichiara il tipo 
di pagina come servizio ed indica la classe che ne 
espone le funzionalità. La seconda direttiva @As- 
sembly viene utilizzata per indicare al compilatore 
JIT di ASRNET in che assembly deve recuperare la 
classe di servizio. La direttiva @Assembly espone an- 
che l'attributo src utile per referenziare un file di 
codice invece che un assembly. A questo punto se 
proviamo a digitare l'indirizzo del servizio nel brow- 
ser avremo un risultato simile a quello di Figura 3. 
Ora possiamo generare la classe proxy che esporrà ai 
client le funzionalità Web Service WCF. L'uso del tool 
svcutil.exe dal prompt dei comandi semplifica note- 
volmente questo passaggio: 




Th( ** 9*W*4 * 4& *H1 * W ****** «** «t *K W»*t *♦ #*** DtHt <***»■ *•* ** f* « 
trtfrW rialti* ifln **M » *H *i **"»■». tv t*ttH/f- 



< 



i Pt«»* « ni 

= r ="-™ .»Elt«Ll»|'*Tta Mila MWU 



F/^f. 3: La home page del servizio 

svcutil.exe http://localhost/WSCalculator 

/WSCalculator.svc?wsdl 

come anche indicato nella pagina di benvenuto 
del web service. Un qualsiasi applicazione client 
scritta con il framework 2.0 non deve far altro che 
includere ed utilizzare la classe proxy per poter 
consumare il web service. 



CONCLUSIONI 

Nell'articolo abbiamo fatto una semplice panora- 
mica di ciò che Windows Comunication 
Foundation può offrire, concentrandoci sulla ver- 
satilità del nuovo framework pensato per lo svilup- 
po di architetture Service-Oriented. Abbiamo visto 
come è semplice realizzare un servizio ed esporlo 
attraverso diversi tipi di hosting, ma anche come è 
semplice includerlo ed utilizzarlo nelle applicazio- 
ni client. Sono personalmente molto affascinato 
da questa tecnologia e spero di aver stuzzicato la 
vostra fantasia. L'articolo è basato su una versione 
beta di WCF, perciò è possibile che qualcosa 
cambi, come è già avvenuto, nel corso delle suc- 
cessive release, perciò vi invito a contattarmi per 
chiarimenti, approfondimenti o critiche attraver- 
so il forum o i contatti presenti nel box laterale. 
Buon lavoro. 

Fabio Cozzolino 
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COMPILARE I SORGENTI DELL'ARTICOLO 



Per compilare la classe di servizio 
utilizziamo la seguente istruzione a 
riga di comando: 

esc RateService.es /target: library 
/out:RateService.dll/reference: System, 
System. ServiceModel 

Per l'applicazione console server 
scriviamo: 

esc /target:exe /out:MainApplication 

Server.cs /reference: System.dll, 



System.ServiceModel.dll, 
RateService.dll | 

Per l'applicazione console client 
compiliamo con questa istruzione: 

esc /target:exe /out:ClientApplication 
Client.cs/reference: System.dll, 
System.ServiceModel.dll, 
RateService.dll 

Il servizio esposto tramite US viene 
compilato "Jus in Time". 
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PROCESSI ASINCRONI 
CON FACILITA' 

FACCIAMO CONOSCENZA CON "BACKGROUNDWORKER" UN COMPONENTE PRESENTE 
IN VISUAL STUDIO 2005, CHE SEMPLIFICA ENORMEMENTE LA VITA AL PROGRAMMATORE 
METTENDOGLI A DISPOSIZIONE AUTOMATISMI PER LA GESTIONE DEI THREAD 
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REQUISITI 



Conoscenze richieste 



.NET Framework 2.0, 

C# 



t 



Windows 2000 o sup.. 
Visual Studio 2005, 
.NET Framework 2.0 



^^3^3 



Tempo di realizzazione 



00 



La naturale evoluzione dell'informatica ci ha 
condotto a poter usare PC sempre più poten- 
ti, con sempre più memoria e con hard- disk 
più capienti. Tutto questo consente ai computer di 
poter compiere operazioni impensabili fino a qual- 
che tempo fa. La velocità dei microprocessori at- 
tuali permette di elaborare grandi quantità di dati, 
immagini, video o grandi database. Nonostante 
questa eccezionale dotazione in termini di hard- 
ware, il 90% delle performance delle applicazioni, 
rimane nelle mani di noi programmatori. Ma cosa 
succederebbe se il nostro programma mentre sta 
compiendo un'elaborazione lunghissima su un'im- 
magine bloccasse ogni altra operazione, in attesa 
che la prima termini? Molto probabilmente la no- 
stra applicazione andrebbe in stallo fino a quando 
l'elaborazione non fosse completa. Questo modo di 
procedere è largamente utilizzato, noto come utiliz- 
zo di un processo sincrono, nel quale l'utente deve 
obbligatoriamente aspettare la fine dell'operazione 
in corso prima di poter fare qualcosa d'altro. Non è 
detto che non si possano utilizzare processi sincro- 
ni nello sviluppo, ma questa soluzione è ottimale 
solo nel caso di operazioni veloci, oppure quando è 
proprio necessario aspettare la fine di un'operazio- 
ne prima di proseguire con la successiva. 
Considerare il caso in cui vogliate salvare un file sul- 
l'hard disk ed inviare un file via e-mail, è necessario 
che la scrittura sia completata prima di procedere 
alla spedizione. In caso di operazioni che possono 
essere svolte senza dipendenze dalle precedenti è 
invece utile implementare soluzioni asincrone in 
cui più task possono essere svolti in parallelo. 
Pensiamo ad esempio alla masterizzazione di un 
DVD o alla scansione di un'immagine. Questi sono 
tipici casi di processi asincroni, cioè porzioni di 
codice che girano parallelamente ad altri processi 
in esecuzione. Il nostro codice fa qualcosa senza 
che l'utente debba per forza aspettarne la fine: l'im- 
portante è poter disporre di uno strumento per 
verificare lo stato dell'elaborazione e per poter rice- 
vere un avviso quando l'elaborazione è terminata. 
Lo scopo di questo articolo sarà proprio illustrare 
come programmare task asincroni all'interno di 



una nostra applicazione, tramite alcune classi di 
.NET, fra le quali spicca in modo particolare il com- 
ponente BackgroundWorker. 



Ul\l PRIMO APPROCCIO 

Supponiamo di lavorare ad un'applicazione che, 
data una fotografia ad alta risoluzione, ne generi il 
negativo. Se programmassimo il tutto in modo sin- 
crono, durante l'elaborazione dell'immagine, fatta 
pixel per pixel, l'interfaccia rimarrebbe bloccata, e 
non potremo spostare la Windows Forms, non po- 
tremo ridimensionarla, non potremo interagire in 
alcun modo con il sotware. L'applicazione dovrà 
aspettare la conclusione dell'elaborazione prima di 
procedere con la prossima istruzione. Molti lin- 
guaggi di programmazione, propongono costrutti 
per la creazione di thread secondari, lasciando nel- 
le mani del programmatore il compito di occuparsi 
anche delle procedure di più basso livello. Anche 
.NET consente la creazione di thread a basso livello, 
ma contemporaneamente mette a disposizione il 
componente BackgroundWorker che "nasconde" al 
programmatore le problematiche di più basso li- 
vello, mettendogli a disposizione una serie di op- 
zioni ad alto livello che consentono di gestire i 
thread in un maniera estremamente efficace ma 
molto semplice. Usando il BackgroundWorker, 
creiamo a tutti gli effetti un thread secondario che 
scansiona l'immagine fino alla fine, lasciando però 
l'applicazione attiva e funzionante. L'utente può 
quindi aprire menu, attivare altre funzioni, ovvia- 
mente facendo attenzione (ma questo è compito 
nostro di noi sviluppatori) che il tutto non vada in 
conflitto con il thread gestito dal BackgroundWor- 
ker. Per poter funzionare correttamente, il Back- 
groundWorker deve conoscere sostanzialmente tre 
cose: cosa deve eseguire, cosa notificare all'utente 
durante il processo e come notificarglielo, cosa de- 
ve fare al termine del processo. Tecnicamente, il 
tutto è implementato attraverso tre eventi esposti 
dalla classe: DoWork, ProgressChanged e RunWor- 
kerCompleted. 
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IN PRATICA 

La nostra applicazione farà esattamente quanto fin 
qui descritto, ovvero elaborare un'immagine, e av- 
viare questa elaborazione in un thread secondario di 
modo che l'applicazione rimanga disponibile per 
ulteriori operazioni. In fase di sviluppo, la nostra 
form sarà composta da 

• una PictureBox {picOriginale): conterrà l'imma- 
gine originale così come caricata dall'hard disk; 

• una PictureBox {picElaborata) : conterrà l'imma- 
gine modificata a seconda dell'algoritmo che 
abbiamo deciso di applicare; 

• un Button {btnSfoglia) : userà la classe OpenFile- 
Dialog per scegliere ed aprire quale immagine 
vogliamo elaborare; 

• un Button {btnNegativo): cliccando, l'immagine 
in picOriginale verrà resa negativa e ridisegnata 
in picElaborata; 

• un Button {btnAnnulla): cliccandolo, l'utente 
può abortire l'esecuzione del processo asincro- 
no; 

• un BackgroundWorker {wrkElabora): ci servirà 
per eseguire processi asincroni di elaborazione 
sull'immagine. 

Il bottone ci servirà per selezionare l'immagine da 
elaborare, un doppio clic sulla voce di menu awierà 
invece il processo di elaborazione, nella stessa ap- 
plicazione ci saranno poi previste altre opzioni, ma 
per iniziare è sufficiente avere conoscenza sempli- 
cemente di questa prima implementazione. Ovvia- 
mente nella stessa form avremo anche un Back- 
groundWorker che ci servirà per gestire il thread, e 
una progressbar che utilizzeremo per visualizzare lo 
stato d'avanzamento dell'elaborazione. 




Fig. 1: Ecco come sarà composta la nostra form 
in fase di elaborazione 

La classe BackgroundWorker è un componente: 
questo significa che quando lo si trascina dalla tool- 
box di Visual Studio 2005 sulla Windows Forms, esso 
verrà posizionato nella tray-area. Di conseguenza, 
rimarrà invisibile a run-time, mentre durante lo svi- 
luppo (design-time) lo possiamo semplicemente se- 



lezionare dalla tray-area, nella parte inferiore della 
Windows Forms. In design-time, il BackgroundWor- 
ker non offre molte possibilità. Le uniche proprietà 
disponibili sono due: WorkerReportsProgress e Wor- 
kerSupportsCancellation. Entrambe sono proprietà 
booleane: la prima attiva la possibilità di notificare 
all'utente lo stato in cui si trova il processo asincro- 
no (ad esempio con una ProgressBar, o un'animazio- 
ne). La seconda proprietà, attiva o meno la possibi- 
lità da parte dell'utente di annullare l'esecuzione del 
processo asincrono. Dopo aver posizionato il Back- 
groundWorker, vediamo di gestire i tre eventi accen- 
nati prima: DoWork, ProgressChanged e RunWorker- 
Completed. Supponendo quindi di avere un Back- 
groundWorker chiamato wrkElabora, cominciamo 
con il ciccare due volte sul bottone, per gestire il 
codice che selezionerà l'immagine da elaborare. Il 
nostro codice avrà la seguente forma: 

private void btnSfoglia_Click(object sender, EventArgs e) 
{ 

/* Sfoglio un'immagine e la salvo nella PictureBox 

* picOriginale */ 

OpenFileDialog dlg = new OpenFileDialogQ; 



dlg.AddExtension = true; 



dlg.CheckFileExists = true; 



dlg.CheckPathExists = true; 



dlg.Multiselect = false; 



dlg. Resto re Directory = true; 



DialogResult res = dlg.ShowDialogQ; 



if (res == DialogResult. OK) 



{ 



Image img = Image.FromFile(dlg.FileName); 



this. picOriginale. Image = img; 



} 



dlg.DisposeQ; 



} 



a questo punto disponiamo dell'immagine originale 
nel controllo picOriginale. Iniziamo l'elaborazione 
cliccando due volte sul menu "Negativo". Il codice di 
gestione è il seguente: 

private void btnl\legativo_Click(object sender, 




MEGLIO IL BACKGROUNDWORKER 



Abbiamo già visto le proprietà più 
importanti esposte del componente 
BackgroundWorker. 

• CancellationPending - ritorna 
un bool che ci dice se l'utente ha 
richiesto oppure no l'interruzio- 
ne del task asincrono. 

• IsBusy - essenziale per evitare di 
cominciare un nuovo task se ne 
è già in esecuzione un altro: il 
framework in questo caso 



genera un'eccezione Invalid- 
OperationException che va 
gestita come di consueto. 

• Work erReports Progress - at- 
tiva o meno la possibilità di 
aggiornare l'interfaccia utente 
della nostra applicazione duran- 
te l'esecuzione. 

• WorkerSupports 
Cancellation - infine, attiva o meno 
la possibilità di annullare 
l'esecuzione da parte dell'utente. 
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EventArgs e) 



255 - clrOrig.B); 



bmpElab.SetPixel(x, y, clrElab); 



// esco se qualcosa non è ok 



if (this.picOriginale.Image == nuli) return; 



if (wrkElabora.IsBusy) return; 



// setto gli handler ed imposto canceled = false 



cancelled = false; 



this.btnAnnulla.Enabled = IwrkElabora.IsBusy; 
this.btnNegativo.Enabled = IwrkElabora.IsBusy; 
this.wrkElabora = new Background Worker(); 
this.wrkElabora.WorkerReportsProgress = true; 
this.wrkElabora. WorkerSupportsCancellation = true; 
this.wrkElabora. DoWork += new 

DoWorkEventHandler(Negativo_DoWork); 
this.wrkElabora. ProgressChanged += new 

ProgressChangedEventHandler( 
Negativo_ProgressChanged); 
this.wrkElabora. RunWorkerCompleted += new 

RunWorkerCompletedEventHandler( 
Negativo_RunWorkerCompleted); 
this.wrkElabora. RunWorkerAsync(); 



Concentriamoci sulle linee di codice 



if (wrkElabora.IsBusy) return; 
this.wrkElabora. DoWork += new 

DoWorkEventHandler(Negativo_DoWork); 
this.wrkElabora. RunWorkerAsyncQ; 



Essenzialmente, il BackgroundWorker vuole sapere 
cosa deve eseguire in modo asincrono: questo risul- 
tato lo si ottiene associando un opportuno handler 
all'evento DoWork. Nel nostro caso, l'handler è Ne- 
gativo _DoWork, per cui ci basta implementare una 
funzione, il cui codice può ad esempio essere il se- 
guente: 

void Negativo_DoWork(object sender, 

DoWorkEventArgs e) 

{ 

inizio = DateTime.Now; 

Color clrOrig; 

Color clrElab; 

bmpOrig = new Bitmap(this.picOriginale.Image); 

bmpElab = new Bitmap(this.picOriginale.Image); 

int width = bmpOrig.Width; 

int height = bmpOrig.Height; 

pixelTotali = width * height; 

// elaboro, uno ad uno, tutti i pixels dell'immagine 

for (y = 0; y < height; y++) 

{ 

for (x = 0; x < width; x++) 

{ 

clrOrig = bmpOrig.GetPixel(x, y); 
clrElab = Color. FromArgb( 

255 - clrOrig. R, 

255 - clrOrig. G, 



} 



Il codice non fa altro che cambiare il colore di ogni 
pixel, rendendo l'intera immagine negativa. Nello 
scrivere codice di questo tipo - che gira in back- 
ground - dobbiamo prestare attenzione all'accesso 
delle risorse: trattandosi di un processo asincrono 
infatti può succedere che un'altra applicazione tenti 
di accedere alla stessa informazione nello stesso 
istante. Inoltre, può accadere che il BackgroundWor- 
ker crei due thread diversi che tentano di scrivere 
sullo stesso file, oppure di accedere allo stesso og- 
getto sulla Windows Forms, e così via. Di fronte a 
questa problematica, possiamo comportarci in mo- 
di diversi: possiamo controllare la proprietà IsBusy, 
che ci dice se il BackgroundWorker sta già eseguen- 
do qualcosa. Oppure, ed è la soluzione più perfor- 
mante e sicura, possiamo utilizzare la keyword lock 
di C# che consente di marcare una porzione di codi- 
ce come critica, assicurando che un determinato og- 
getto sia utilizzato da un solo thread alla volta. Pos- 
siamo quindi decidere di implementare nel ciclo for 
più interno del codice sopra come indicato di segui- 
to: 



lock(bmpElab) 


{ 


bmpElab.SetPixel(x, 


y, clrElab); 


} 



Nel nostro esempio, l'oggetto critico è la Bitmap 
bmpElab, che contiene l'immagine modificata: di 
conseguenza, inseriamo questo codice in un blocco 
lock, che ci assicura che quell'oggetto in quel dato 
istante venga manipolata da un solo thread. 



COMUNICAZIONI 
ALL'UTENTE 

In condizioni normali, in .NET dobbiamo fare atten- 
zione ad aggiornare l'interfaccia utente, perché pos- 
siamo farlo esclusivamente dal thread principale 
della nostra applicazione. Il componente Back- 
groundWorker nasconde questa particolare com- 
plessità. Di conseguenza, l'unica cosa richiesta è 
l'implementazione di due handler diversi: uno per 
l'evento ProgressChanged ed uno per l'evento Run- 
WorkerCompleted. Come è facile intuire, il primo 
viene sollevato durante l'esecuzione - a nostra di- 
screzione - mentre il secondo avviene al termine 
dell'esecuzione, oppure quando l'esecuzione viene 
annullata. Gli handler vengono associati come di 
consueto: 
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this.wrkElabora.ProgressChanged + = 

new ProgressChangedEventHandler( 
Negativo_ProgressChanged); 
this.wrkElabora.RunWorkerCompleted += new 

RunWorkerCompletedEventHandler( 
Negativo_RunWorkerCompleted); 

Per poter gestire correttamente l'evento Progress- 
Changed, è necessario impostare a true la proprietà 
WorkerReportsProgress. All'interno della funzione 
Negativo _DoWork che abbiamo implementato pri- 
ma, quindi, solleviamo l'evento ProgressChanged: 

Negativo_ProgressChanged (this, new 

ProgressCnangedEventArgs(0, bmpElab)); 

che viene gestito dal suo corrispondente handler. 

void Negativo_ProgressChanged(object sender, 

ProgressChangedEventArgs e) 
{ 

this.picElaborata.Image = (Bitmap)e.UserState; 

y~ 

In pratica, l'utente può sapere a che punto è l'elabo- 
razione dell'immagine. L'handler utilizza la classe 
ProgressChangedEventArgs, derivata da EventArgs, 
che permette di passare parametri dal thread che re- 
gola il processo asincrono. Infine, non ci resta che 
gestire l'evento RunWorkerCompleted, nel quale av- 
visiamo l'utente che l'operazione è terminata. 

void Negativo_RunWorkerCompleted(object sender, 

RunWorkerCompleted EventArgs e) 
{ 

string output; 

/* Scrivo l'immagine modificata sulla PictureBox 
* picElaborata */ 
this.picElaborata.Image = bmpElab; 



output = string. Format("Operazione 

COMPLETATA!\nSono stati modificati {0} 
pixels!\n\nTempo : {1}.", x * y, 
intervallo. ToStringO); 
MessageBox.Show(output, "IoProgrammo"); 



} 



Nel codice qui sopra, renderizzo su picElaborata 
l'immagine in negativo, e poi avviso l'utente con una 
normale MessageBox. 



ANNULLARE 
L'ESECUZIONE ASINCRONA 

Una delle possibilità più interessanti che possia- 
mo offrire all'utente è la possibilità di interrompe- 



re l'esecuzione del processo, nel caso in cui voglia 
tornare indietro o ad esempio ripeterla con para- 
metri differenti. Il BackgroundWorker ovviamente 
consente questa tecnica, nella quale dobbiamo 
però gestire le cose manualmente. 
Per prima cosa, dobbiamo impostare a trueìa pro- 
prietà WorkerSupportsCancellation del Back- 
groundWorker. Successivamente, dobbiamo per 
esempio aggiungere un nuovo Button sulla Win- 
dows Form, che l'utente può cliccare per richiede- 
re l'interruzione. 

Possiamo poi aggiungere un Button btnAnnulla 
sulla form, associando il seguente codice: 

private void btnAnnulla_Click(object sender, 

EventArgs e) 
{ 

this.wrkElabora.CancelAsyncQ; 




} 



L'interruzione del processo asincrono non è com- 
pletamente automatica. La chiamata al metodo 
CancelAsync non fa altro che impostare la pro- 
prietà CancellationPending del componente, che 
dobbiamo quindi monitorare nella function Do- 
Work per bloccare a tutti gli effetti. 

if (wrkElabora. CancellationPending) 

{ 

// forzo l'uscita dal loop 
break; 

y~ 

Il blocco if riportato qui sopra controlla la pro- 
prietà CancellationPending: se vale true, il loop 
contenuto nella funzione Negativo JDoWork viene 
interrotto. Non dimentichiamoci che anche se l'u- 
tente interrompe l'esecuzione del processo, viene 
comunque scatenato l'evento RunWorkerComple- 
ted. Spetta al nostro codice discriminare le moda- 
lità con cui l'esecuzione del processo termina: il 
codice C# completo presente nel progetto allega- 
to utilizza ad esempio una variabile booleana. 



CONCLUSIONI 

Il BackgroundWorker è un efficace componente 
del Framework 2.0, semplice da usare e veloce da 
integrare nel nostro codice, che con poco sforzo ci 
permette di realizzare software di una certa com- 
plessità, che consentono di eseguire processi in 
background, mentre l'utente continua ad utilizza- 
re la nostra applicazione. 

Il BackgroundWorker nasconde allo sviluppatore 
molta della complessità presente invece in altri 
componenti di altri linguaggi di programmazione. 

Igor Damiani 
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IMPARIAMO A USARE 
LE STORED PROCEDURES 

ECCO COME POSSIAMO ACCELERARE LE PRESTAZIONI DEL DATABASE MEMORIZZANDO 
LE QUERY DIRETTAMENTE SUL SERVER, E LASCIANDO AL DATABASE IL COMPITO 
DI GESTIRLE AL MEGLIO 




CJ CD LI WEB 

zip 



''gM^jEEjjSEmSm 




I 



Windows 2000, SQL 
Server 2000, 
.Net Framework 



Tempo di realizzazione 



00 



Problema: stiamo scrivendo il gestionale 
della nostra vita, quello che ci lancerà nel- 
l'universo dei programmatori ricchi e 
famosi! All'interno di questo gestionale utilizzia- 
mo frequentemente una query chilometrica. 
Tutte le volte che ci occorre la nostra query, 
siamo costretti a copiarla da una parte all'altra 
del codice. Siccome siamo bravi, abbiamo creato 
una classe per gestire la query in questione di 
modo che, se volessimo cambiarla, dovremmo 
farlo solo una volta. Tuttavia, all'interno del pro- 
gramma, siamo costretti ogni volta ad instanzia- 
re un oggetto della classe ecc, inoltre la classe 
stessa al suo interno dovrà provvedere alla con- 
nessione con il database, l'invio dei comandi 
SQL ed ogni altra operazione che sia necessaria a 
gestire il tutto, con conseguente spreco di risorse 
e agilità del nostro software. Proviamo a fare 
un'altra ipotesi. E se la query sql fosse diretta- 
mente immagazzinata in sql server? Ad esempio 
potremmo salvare la nostra query in sql server ed 
attribuirli un nome, per poi richiamarla dall'in- 
terno del nostro programma direttamente trami- 
te la sua etichetta. Quali vantaggi ci porterebbe 
questo approccio? Sicuramente il nostro pro- 
gramma sarebbe più leggero, la query sarebbe 
disponibile anche ad altri software che potreb- 
bero utilizzarla in modo trasparente senza cono- 
scerne realmente i dettagli implementativi, il 
risultato sarebbe leggermente più veloce in 
quanto eseguita dal db stesso senza ricorrere ad 
oggetti intermedi. Quello che faremo in questo 
articolo sarà esattamente imparare a creare 
query "immagazzinate" direttamente in SQL 
Server, ovvero quelle che in linguaggio tecnico 
vengono chiamate "Stored Procedure". Per tutti i 
vostri esperimenti potrete usare Microsoft SQL 
server express edition 2005 allegato al CD pre- 
sente in questo stesso numero di ioProgrammo. 



SI INIZIA! 

Tecnicamente una stored procedure è com- 
posta da una serie di istruzioni T-SQL memo- 



rizzate in SQL Server. L'insieme delle istruzio- 
ni preso come elemento unico rappresenta 
una Stored Procedure, che ovviamente viene 
identificata da un nime. A differenza delle 
query eseguite nel query analyzer, o via codi- 
ce, le stored procedure vengono compilate da 
SQL Server prima di essere eseguite. È chiaro, 
quindi, che una stored procedure è tipica- 
mente più veloce della query corrispondente. 
Il miglioramento delle prestazioni non è l'uni- 
co vantaggio delle stored procedure, isola- 
mento e crittografia sono altri aspetti che non 
possiamo trascurare. 

Senza entrare nel dettaglio, pensiamo alla 
possibilità di limitare i privilegi sulla struttura 
del database agli utenti delle nostre applica- 
zioni consentendo l'accesso alla singola sto- 
red procedure che recupera i dati e non un 
accesso diretto alle tabelle. Esiste poi la possi- 
bilità di crittografare una stored procedure in 
modo da non permettere l'accesso alle istru- 
zioni T-SQL che la compongono. 
Le stored procedure, una volta memorizzate, 
possono essere eseguite sia nel query analy- 
zer sia nei nostri programmi come fossero dei 
comandi T-SQL. Si evidenzia in questo modo 
un altro vantaggio derivante dal loro utilizzo: 
supponiamo di avere una query che eseguia- 
mo in diverse applicazioni e di renderci conto 
dopo un periodo di utilizzo che questa può 
essere ottimizzata. In teoria dovremmo anda- 
re a modificare tutte le nostre applicazioni. 
Mentre se utilizzassimo una stored procedure 
sarebbe sufficiente modificarla all'interno del 
SQL Server per ottenere i benefici desiderati 
in tutte le applicazioni che la utilizzano. 



CREARE UNA STORED 
PROCEDURE 

Esistono due modi per creare una stored pro- 
cedure: il primo passa attraverso tramite l'i- 
struzione CREATE PROCEDURE nel query 
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analyzer, il secondo fa uso esclusivamente 
dell' enterprise manager. Gli esempi di questo 
articolo faranno riferimento ad una tabella 
chiamata Utenti formata dai campi: idUtente, 
nome, cognome, email e dataScadenza. 
La query T-SQL per la creazione della tabella è 
la seguente: 

CREATE TABLE [Utenti] ( 

[idUtente] [int] IDENTITY (1, 1) NOT NULL , 

[nome] [varchar] (50) COLLATE 

Latin l_General_CI_AS NOT NULL , 

[cognome] [varchar] (50) COLLATE 

Latin l_General_CI_AS NOT NULL , 
[email] [varchar] (50) COLLATE 

Latin l_General_CI_AS NOT NULL , 

[dataScadenza] [datetime] NOT NULL 

CONSTRAINT [DF_Utenti_dataIscrizione] 
DEFAULT (DATEADD(yyyy, 1, GETDATE())), 
CONSTRAINT [PKJJtenti] PRIMARY KEY CLUSTERED 

_J 

[idUtente] 



EXEC dbo.listUsers 



) ON [PRIMARY] 



) ON [PRIMARY] 



GO 



Una volta creata la tabella, popolatela pure 
con dei dati, di modo che il resto dell'articolo 
sia maggiormente comprensibile. 



LA PRIMA STORED 
PROCEDURE 

Supponiamo di voler leggere nome ed email 
dalla tabella Utenti appena creata, ordinati 
per nome. La query SQL sarebbe molto sem- 
plice 

SELECT nome, email 

FROM Utenti 

ORDER BY nome 

Partendo da questa query creiamo la nostra 
prima stored procedure: 

CREATE PROCEDURE dbo.listUsers 

AS 

SELECT nome, email 

FROM Utenti 

ORDER BY nome 



Eseguendo il codice T-SQL, viene creata la 
stored procedure "dbo.listUsers" che, se ese- 
guita, restituirà nome ed email degli utenti 
presenti nella tabella. Per eseguire la stored 
procedure è sufficiente digitarne il nome (il 
comando EXEC è facoltativo). 



Vediamo in figura il risultato dell'esecuzione 



Proprietario: 
Data di creazione: 



Testo: 



CREATE PROCEDURE dbo.listUsers 

AS 

SELECT nonne, email 

FROM utenti 

ORDER BYnome 



Fig. 2 Definizione dello script T-SQL 



CREAZIONE DI STORED 
PROCEDURE DA 
ENTERPRISE MANAGER 

Le stored procedure possono essere create an- 
che utilizzando Tenterprise manager di SQL 
Server. Per farlo, clicchiamo con il tasto destro 
del mouse "Stored procedure" per il database 
che ci interessa, e selezioniamo "Nuova stored 
procedure...". 

Scriviamo quindi la nostra query T-SQL e clic- 
chiamo su Ok. 



CRIPTARE UNA STORED 
PROCEDURE 

È possibile specificare l'opzione WITH EN- 
CRYPTION per proteggere la query della no- 
stra stored procedure. 



CREATE PROCEDURE dbo.listUsersEnc WITH 

ENCRYPTION 


AS 


SELECT 


nome, email 




FROM 


Utenti 




WHERE 


DATEDIFF( d, GETDATEQ, 


dataScadenza ) = 7 



La stored procedure viene criptata e il conte- 
nuto T-SQL risulta protetto da visualizzazioni 
indesiderate. 



MODIFICA 

E CANCELLAZIONE 

DI STORED PROCEDURE 

Possiamo poi modificare o eliminare una sto- 
red procedure grazie alle istruzioni ALTER e 
DROP. Supponiamo di voler visualizzare solo 
gli utenti la cui iscrizione scade tra una setti- 
mana: 




T-SQL 

T-SQL, acronimo di 
Transact-SQL è la 
versione proprietaria 
di SQL utilizzata da 
Microsoft SQL Server. 
Ne mantiene i costrutti 
base ma fornisce 
funzionalità aggiuntive 
per la manipolazione e 
l'estrazione dei dati. 
È un vero e proprio lin- 
guaggio di program- 
mazione che consente 
di utilizzare variabili, 
fornisce una serie di 
istruzioni condizionali 
e di ciclo ed altro 
ancora. 
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SQL MAIL 

SQL Mail è uno stru- 
mento di SQL Server 
che consente di inviare 
e ricevere email. Per 
funzionare ha bisogno 
di utilizzare un account 
di posta che può essere 
configurato dal pan- 
nello di controllo di 
Windows. 
Una volta configurato 
il servizio è possibile 
utilizzare delle stored 
procedure quali 

xp_startmail 

xp_stopmail 

xp_sendmail 

xp_readmail 

xp_deletemail 

xp_findnextmsg 

sp_processmail 

per l'invio e la ricezio- 
ne di messaggi email. 



ALTER 


PROCEDURE dbo.listllsers 


AS 


SELECT 


nome, email 




FROM 




Utenti 




WHERE 


DATEDIFF( d, 


GETDATEQ, 


dataScadenza ) = 7 



La sintassi per la cancellazione della stored 
procedure è invece: 

DROP PROCEDURE dbo.listUsers 



E SE CI FOSSERO 
DEI PARAMETRI? 

Una stored procedure accetta parametri in in- 
gresso e può fornire dei parametri di output. 
Questi sono molto utili per rendere le proce- 
dure dinamiche. La sintassi di dichiarazione è 
molto semplice: supponiamo di voler para- 
metrizzare il numero di giorni per il controllo 
della data di scadenza: 



CREATE PROCEDURE 



dbo.listUsersParams 



@NumGiorni INT 



AS 



SELECT nome, email 



FROM Utenti 



WHERE 



DATEDIFF( d, GETDATE(), dataScadenza ) = 

@NumGiorni 

A questo punto eseguendo 

EXECUTE dbo.listUsersParams 7 

otteniamo la lista degli utenti la cui data di 
scadenza per una qualche operazione è tra 7 
giorni. 

Per impostare dei parametri di ritorno occor- 
re utilizzare la parola chiave OUTPUT. 



CREATE 


PROCEDURE dbo.getEmailFromld 


@idUtente INT, 


@email VARCHAR(50) OUTPUT 


AS 


SELECT 


@email = email 


FROM 


Utenti 


WHERE 


idUtente = @idUtente 



Abbiamo ottenuto una procedura che ci resti- 
tuisce l'email di un utente a partire dall'id. Per 
eseguire la procedura scriviamo: 

DECLARE @email VARCHAR(5Q) 

EXECUTE dbo.getEmailFromld 2, @email OUTPUT 



UTILIZZARE LE STORED 

PROCEDURE 

PER AGGIORNARE 

UNA TABELLA 

Possiamo utilizzare delle stored procedure 
parametriche per inserire o modificare dei re- 
cord di una tabella. Vediamo subito un esem- 
pio di inserimento: 

CREATE PROCEDURE dbo.InsertUser 

@nome VARCHAR(50), 
©cognome VARCHAR(50), 



©email VARCHAR(50) 



AS 



INSERT INTO Utenti 



( 



[nome], 



[cognome], 



[email] 



) 



VALUES 



( 



@nome, ©cognome, @email 



SELECT 



@email 



) 



Abbiamo creato una procedura che accetta 
come parametri nome, cognome ed email. 
La procedura esegue una query di Inserì sul 
database creando di fatto un nuovo record. 
Per l'esecuzione ci basta scrivere 

dbo.InsertUser 'Archimede', 'Pitagorico', 

'achimede@paperopoli.dys' 

Se vogliamo conoscere anche Fid del nuovo 
utente inserito occorre scrivere 

dbo.InsertUser 'Archimede', 'Pitagorico', 

'achimede@paperopoli.dys' 
SELECT @@identity 

Analogamente possiamo creare una stored pro- 
cedure per la modifica dei dati di una tabella 

CREATE PROCEDURE dbo.UpdateUser 
@idUtente INT, 
@nome VARCHAR(50), 
©cognome VARCHAR(50), 
@email VARCHAR(50) 

AS 

UPDATE Utenti 

SET 

[nome] = @nome, 
[cognome] = ©cognome, 
[email] = @email 
WHERE idUtente = @idUtente 



Per modificare l'utente con idUtente - 11 ad 
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esempio possiamo scrivere la seguente query cmd.CommandType = CommandType.StoredProcedure; 



dbo.Updatellser 11, 'Pietro', 'Gambadilegno', 

'pietro@topolinia.dys' 

L'inserimento e modifica dei dati tramite stored 
procedure, da una serie di vantaggi tra cui la 
possibilità di utilizzare il codice scritto in più 
progetti e soprattutto l'isolamento dei dati au- 
mentando di fatto la protezione dei dati. 



cmd.Parameters.Add(new 

SqlParameter("@nomGiorni", numGiorni)); 

VB.Net 

Dim cmd As SqlCommand = New 

SqlCommand("listUsers ", conn) 
cmd.CommandType = CommandType.StoredProcedure 
cmd.Parameters.Add(new 

SqlParameter("@nomGiorni", numGiorni)); 




ESEGUIRE STORED 
PROCEDURE IH! 



Per eseguire una stored procedure in ambien- 
te .Net possiamo utilizzare le funzionalità for- 
nite dai namespace System. Data e System.Da- 
ta.SqlClient. Il namespace System. Data.Sql- 
Client ha un oggetto chiamato SqlCommand, 
che consente di eseguire delle query su data- 
base. Una volta impostata la connessione, oc- 
corre impostare il valore della poprietà Com- 
mandType dell'oggetto SqlCommand a "Sto- 
redProcedure". 
Vediamo come: 



C# 
SqlCommand cmd 



new SqlCommand( 

"listUsers", conn); 



cmd.CommandType = CommandType.StoredProcedure; 

VB .Net 
Dim cmd As SqlCommand = New 

SqlCommand("listUsers ", conn) 
cmd.CommandType = CommandType.StoredProcedure 

Quando creiamo l'oggetto di tipo SqlCom- 
mad, dobbiamo passargli come parametro il 
nome della stored procedure da eseguire. 
Impostiamo il command-type dopodiché sia- 
mo pronti ad eseguire la stored procedure. 



PASSARE I PARAMETRI 
ALLA STORED 
PROCEDURE 

Per passare dei parametri ad una stored pro- 
cedure parametri occorre utilizzare il metodo 
Add della collection Parameters. Il metodo 
accetta come parametro un oggetto di tipo 
SqlParameter contenente la coppia "nome 
parametro" -"valore" come nell'esempio 



UN ESEMPIO COMPLETO 

In questo esempio realizziamo un'applicazio- 
ne console che esegue una stored procedure, 
ne legge il recordset risultante e stampa i dati 
a video. 



I CURSORI 



I Cursori consentono di elaborare 
un set di risultati di query SQL. 
In particolare, permettono il 
posizionamento sulle singole 
righe del set di risultati e offro- 
no la possibilità di recuperarne il 
contenuto. 

Un cursore viene dichiarato tra- 
mite la seguente sintassi: 

DECLARE NomeCursore CURSOR 

FOR QueryDiSelezione 

Invece, per il recupero delle 
tuple, viene utilizzata l'istruzio- 
ne FETCH che consente di memo- 
rizzare i valori della tupla corren- 
te all'interno di variabili. 



Vediamo un semplice esempio in 
cui dichiariamo un cursore che 
contiene il risultato di una query 
e lo scorriamo stampandone il 
contenuto: 



DECLARE @nome 


VARCHAR(50) 


DECLARE usersCur 


CURSOR 


FOR SELECT nome 


FROM Utenti 


OPEN usersCur 


FETCH usersCur INTO @nome 


WHILE @@FETCH_ 


STATUS = 


BEGIN 


PRINT @nome 


FETCH usersCur 


INTO @nome 


END 


CLOSE usersCur 



DEALLOCATE usersCur 



Apriamo Visual Studio e creiamo una nuova 
console application. Occorre importare i na- 
mespace System. Data e System. Data. Sql- 
Client. La stored procedure che utilizziamo è 
quella già vista negli esempi precedenti 
"checklnScadenza". Le operazioni che effet- 
tuiamo sono: apertura della connessione, 
impostazione della stored procedure, esecu- 
zione e visualizzazione dei dati. Alla fine fac- 
ciamo pulizia degli oggetti aperti. 

C# 

using System; 
using System. Data; 
using System. Data. SqlClient; 



C# 
SqlCommand cmd = new 

SqlCommand("checkInScadenza ", conn); 



namespace TestStored Procedure 



class TestStored Procedure 
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{ 




SUL WEB 



SQL Server Central 

http://www.sqlservercentral 
.corri 

SqIJunkies 

http://www.sqljunkies.com 




Carmelo Scudieri è 
ingegnere informatico. 
Si occupa di sviluppo 
software web-based 
per una società di 
telecomunicazioni di 
Milano. 

Gestisce un sito web 
ricco di script e 
manuali per chi si 
affaccia al mondo della 
programmazione web 
(www.morpheusweb.it) . 



[STAThread] 



static void Main(string[] args) 



{ 



int numGiorni = 7; 



string connStr = "Server=(local); 

DataBase=test;Integrated Security=SSPI"; 



SqlConnection dbConn = nuli 



SqlDataReader aReader = nuli; 



Console. Writel_ine("Utenti in scadenza"); 



try 



{ 



// creo l'oggetto connection 



dbConn = new SqlConnection(connStr); 



dbConn.Open(); 



// creo l'oggetto command 



SqlCommand cmd = new SqlCommand( 

"checklnScadenza", dbConn); 



// imposto il tipo di comando 



cmd.CommandType = 

CommandType.Stored Procedure; 



// Aggiungo i parametri 



cmd.Parameters.Add(new SqlParameter( 

"@NumGiorni", numGiorni)); 



// eseguo 



aReader = cmd.ExecuteReaderQ; 



// stampo i risultati 



while (aReader.Read()) 



{ 



Console. Writel_ine( 



"Nome: {0}; Email: {!}", 



aReader["nome"], 



aReader["email"]); 



} 



finally 



{ 



if (dbConn != nuli) 



dbConn. CloseQ; 



if (aReader != nuli) 



aReader.Close(); 



VB.Net 




Imports System. Data 


Imports System. Data. SqlClient 


Module TestStored Procedure 


Sub Main() 


Dim numGiorni As Integer = 7 


Dim connStr As String = "Server=(loca); 

DataBase=test;Integrated Security=SSPI" 


Dim dbConn As SqlConnection = 


Nothing 


Dim aReader As SqlDataReader = 


= Nothing 



Console. Writel_ine("Utenti in scadenza") 
Try 
' creo l'oggetto connection 
dbConn = New SqlConnection(connStr) 
dbConn. Open() 
' creo l'oggetto command 
Dim cmd As SqlCommand 
cmd = New SqlCommand("checkInScadenza", 

dbConn) 
' imposto il tipo di comando 
cmd.CommandType = 

CommandType.StoredProcedure 
' Aggiungo i parametri 
cmd.Parameters.Add(New SqlParameter( 

"@NumGiorni", numGiorni)) 
1 eseguo 

aReader = cmd.ExecuteReader() 
1 stampo i risultati 
Do While aReader. Read() 
Console. Writel_ine("Nome: {0}; Email: {1}", 

aReader("nome"), aReader("email")) 
Loop 
Finally 
If Not dbConn Is Nothing Then 
dbConn. Close() 

End If 

If Not dbConn Is Nothing Then 
aReader.Close() 

End If 

End Try 
End Sub 



End Module 



CONCLUSIONI 

Le Stored Procedure rappresentano una solu- 
zione molto flessibile e potente per gli ammi- 
nistratori di database come per i programma- 
tori. Se usate in congiunzione ai JOBS di cui 
parliamo in questo stesso numero di ioPro- 
grammo consentono un'amministrazione 
pressoché automatica di ogni operazione le- 
gata a SQL Server, dal backup alla manuten- 
zione delle tabelle. La disponibilità di una ver- 
sione express di SQL Server rappresenta un'e- 
norme ricchezza a cui tutti i programmatori 
possono attingere per testare i loro program- 
mi. In caso di software che non devono gesti- 
re basi di dati sopra i 4 GB, SQL server express 
rappresenta anche una soluzione operativa. 
Certo, per la gestione dei JOBS, le utility di 
reportistica e le altre caratteristiche avanzate, 
SQL Server Standard edition rappresenta l'u- 
nica soluzione possibile in applicazioni di 
carattere enterprise. 

Carmelo Scuderi 
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FACCIAMO FARE IL 



u 



LAVORO" A SQL SERVER 



ALLA SCOPERTA DI UNA DELLE FUNZIONALITÀ AVANZATE DEL NUOVO PRODOTTO 
DI MICROSOFT SCOPRIREMO COME CON POCO SFORZO SIA POSSIBILE FAR COMPIERE 
DIRETTAMENTE AL DB OPERAZIONI RIPETIVE 




Una delle funzionalità presenti in SQL Server 
2005 che maggiormente saranno apprezza- 
te dai programmatori come dagli ammini- 
stratori è quella relativa ai JOBS. I Jobs sono assimi- 
labili ad una serie di "Macro" che possono essere 
eseguite direttamente da SQL Server secondo sca- 
denze temporali impostate dall'amministratore di 
sistema. Utilizzeremo questo articolo per inviare 
un'email di notifica agli utenti presenti nel database 
effettuando un controllo su una data di scadenza 
contenuta in una tabella utenti. Il nostro job sarà 
eseguito più volte al giorno, e se verificherà che ci 
sono utenti che hanno una data di scadenza inferio- 
re a una prefissata prowederà a notificargli la sca- 
denza con un'email. In tutto questo non tocchere- 
mo una sola riga di codice in nessun linguaggio di 
alto livello, ma faremo tutto direttamente da SQL. 



m 



n 



Generale p a M ioni Nohhche I 

10 Nome: (Nuovo Job 



Datad creazione. (non ancora creato] 

Categoria: | [Senza categoria (locale)] ^\ \ 

Proprietario: sa _^J 



Origine: (locai) 

f? Attivato '•• Server tar- <' 

C Serve! I. 



Un Job di tesl| 



Data ultima modifica 



I Annulla Applica | 



Fig. 2: Creazione di un Job 

Una volta inserite le informazioni base è possibile 
definire una o più azioni da effettuare all'esecuzio- 
ne del Job. Da tab ''Passaggi" cliccare su "Nuovo". 
Viene visualizzata una maschera in cui è possibile 
scegliere: un nome per il passaggio, il tipo di pas- 
saggio (se uno script T- SQL, un ActiveX, un coman- 
do di sistema...), il database su cui lavorare ed infi- 
ne il comando. 



n 




REQUISITI 



- SQL Server, T-SQL, 
| C#oVB.Net 

Windows 2000, SQL 
Server 2000, .Net 
Framework 



I 



Tempo di realizzazione 



00 



INIZIAMO 

L'elemento principale è l'Agente SQL Server accessi- 
bile sotto la cartella Gestione dell'istanza del server. 



r-jKg Funzioni definite dall'utente 
Qf Cataloghi full-text 
FR P~l Data Transforrnation 5ervices 
ÉI Q Gestione 

B-^ Agente SQL Server 

;-"0 avvisi 

^ Operatori 
Q] Processi 
|-{^ Backup 
! ®~% Attività corrente - 08/04/2006 1 7 . 04 . 
ìjj^ Piani di manutenzione database 
+ Q Log di SQL Server 
BCU Replica 

r-t r....L._:.__ 





Fig. 1: Agente SQL Server 

I Job vengono gestiti tramite una serie di azioni: la 
definizione del job, la gestione delle azioni da ese- 
guire, la pianificazione delle esecuzioni e la defini- 
zione dei messaggi di notifica. Per creare un nuovo 
Job, occorre cliccare con il tasto destro del mouse 
sulla voce Job (o Processi) e selezionare "Nuovo 
Processo..." Nel tab "Generale" vanno inserite alcune 
informazioni generali sul Job quali: nome, categoria, 
proprietario e descrizione. 



Generale Pa:: i ,1,1, i on i Notifiche | 



Generale | Avanzate | 

''«orne Operazione da eseguire 



|ScriptTransact-SQL(TSQL) 



Database: (test 

Comando 



Apri... | 



Vai a: | 0K | Annulla | Applica | ? 



Fig. 3: Definizione dei passaggi 

Dal tab "Avanzate" e inoltre possibile definire le azio- 
ni da eseguire in caso di esito positivo o negativo del 
passaggio e delle opzioni di eventuali comandi T- 
SQL. La terza operazione da effettuare è la schedula- 
zione del Job. Dal tab "Pianificazioni", cliccare su 
"Nuova pianificazione" e scegliere il tipo di schedu- 
lazione. La maschera è molto intuitiva e non neces- 
sita di particolari conoscenze. 
Per le pianificazioni periodiche è possibile impo- 
starne la frequenza cliccando sul pulsante "Cam- 
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Generale | Passa. Piani ioni Notifiche | 
fp\ Nota: la data/ora corrente nel server target "TJ è 08/04/2006 1 9.50 



»> Non 



Attivato Di 



Nome 


iGiornaliera 


W Attivata 






C Avvia autom cani ll'avvio di nte SQL Server 

Avvia quando la CPU risulta inattiva 


r 

a- 


Una volta 
Periodica 


alle ore: 1 19.51. 00 ^ 




A intervalli di 1 giorno/i, alle 1.00.00 




\ Cambia... | 









I Annulla | ? 



Fig. 4: Pianificazione delle esecuzioni 

bla..". L'ultima azione da eseguire è l'impostazione 
delle notifiche. Dal tab "Notifiche" è possibile sce- 
gliere chi notificare ed in che modo farlo in caso in 
esito positivo o negativo, o semplicemente al termi- 
ne dell'esecuzione. Creato il Job, questo verrà visua- 
lizzato nella lista dei Processi e potrà essere modifi- 
cato o cancellato dall'amministratore del database. 











Generale] Pass Fìanihi ioni Notifiche | 


.■ . Azioni da eseguire 

v t'otn.Lc uf elatere 
lpcr v aelc"ionicól 

l~~ Notifica operatore 
(cercapersone): 

Notifica operatore 
(Net Send]: 

P Scrivi nel ri 
\~ Elimina il pi 


j| cori.plei amento d;l procji'u 






admin 


J_| |,nca 


; li esito negativo pr sesso » 








1 


J_| |,nca 


so di esito negativo processo _J 








1 


J_| |,nca 


d die ito negati ■ processo ^l 


delle applicazioni di Vi idowi: 






^7a 


.•: die.i'c negati' :< ooce::o •*• 






r^ 


so di esito positivo processo _-| 














L 


OK | Annulla 


| Applica | ? 









Fig. 5: Gestione delle notifiche 



denza ed una 7 giorni prima. L'intero processo verrà 
gestito tramite una stored procedure paramedica di 
SQL Server e la creazione di un Job che verrà sche- 
dulato con frequenza giornaliera e si occuperà del- 
l'esecuzione della stored procedure. Consideriamo 
una query di base: 

SELECT nome, email 

FROM Utenti 

WHERE 

DATEDIFF(d, GETDATE(), dataScadenza) = @NumGiorni 

Questa non fa altro che selezionare gli utenti che 
hanno come data di scadenza "Oggi + NumGiorni". 
A questo punto possiamo scrivere la procedura: 



CREATE PROCEDURE 



[checklnScadenza] 



pnumGiorni INT — La variabile 



AS 



DECLARE @nome VARCHAR(50) 



DECLARE @email VARCHAR(50) 



aa DECLARE @msg VARCHAR(8000) 



— Creiamo un cursore per scorrere il risultato della query 



DECLARE 



utentiScadenza CURSOR FOR 



SELECT nome, email 



FROM Utenti 



WHERE 



DATEDIFF(d, GETDATEQ, dataScadenza) = @NumGiorni 



OPEN utentiScadenza 



■"liBÉl 

Ctt 



FETCH utentiScadenza INTO @nome, @email 



LA NOTIFICA 

L'esempio ha come prerequisito l'esistenza di una 
tabella utenti 



CREATE TABLE [Utenti] ( 

[idUtente] [int] IDENTITY (1, 1) NOT NULL , 

[nome] [varchar] (50) COLLATE 

Latin l_General_CI_AS NOT NULL , 

[cognome] [varchar] (50) COLLATE 

Latin l_General_CI_AS NOT NULL , 

[email] [varchar] (50) COLLATE 

Latin l_General_CI_AS NOT NULL , 

[dataScadenza] [datetime] NOT NULL 

CONSTRAINT [DF_Utenti_dataIscrizione] 

DEFAULT (DATEADD(yyyy, 1, GETDATEQ)), 

CONSTRAINT [PKJJtenti] PRIMARY KEY 

CLUSTERED 

([idUtente]) ON [PRIMARY] 

) ON [PRIMARY] 

GO 



Il nostro job invierà un'email di notifica 15 giorni pri- 
ma della scadenza prefissata nel campo dataSca- 



— Per ogni tupla trovata inviamo una e-mail 

WHILE @@FETCH_STATUS = 

BEGIN 

SET @msg = " 

SET @msg = @msg + 'Gentile ' + @nome 
+ ',' + CHAR(IO) + CHAR(IO) 

SET @msg = @msg + 'La tua iscrizione scade tra ' 



SET @msg = @msg 



CONVERT(VARCHAR(4), 

(cpnumGiorni) 



SET @msg = @msg + CHAR(IO) + CHAR(IO) 
SET @msg = @msg + 'ti invitiamo a rinnovarla ... ' 
SET @msg = @msg + CHAR(IO) + CHAR(IO) 
SET @msg = @msg + 'Morpheusweb.it' + CHAR(10) 
SET @msg = @msg + 'mailto: 

webmaster@morpheusweb.it' + CHAR(10) 



SET @msg = @msg + 

'http://www.morpheusweb.it' 



CHAR(10) 



EXEC MASTER. DBO.XP_STARTMAIL 



Puser = 'UtenteMaiISQL' 



EXEC MASTER.DBO.XP_SENDMAIL 



(gjrecipients = @email, 



@subject = 'Utente in scadenza', 
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@message = @msg 



EXEC MASTER. DBO.XP_STOPMAIL 



-- passiamo alla tupla successiva 



FETCH utentiScadenza INTO @nome, @email 



END 



CLOSE 



utentiScadenza 



DEALLOCATE utentiScadenza 

Abbiamo dichiarato una stored procedure chiamata 
checklnScadenza che accetta come parametro un 
intero NumGiorni. La procedura utilizza un cursore 
che permette di scorrere le tuple ottenute dalla que- 
ry che rappresentano gli utenti in scadenza. Per ogni 
tupla viene composto un messaggio contenente le 
informazioni da inviare all'utente; vengono quindi 
richiamate tre stored procedure di sistema: XP_ 
STARTMAIL, XP_SENDMAIL e XP_STOPMAIL che 
consentono di inviare la mail all'utente in scadenza. 
Si passa quindi alla tupla successiva, fino alla fine. 
Dopo l'invio delle mail, il cursore viene chiuso e 
deallocato. Salvata la stored procedure, procediamo 
alla creazione del Job che la eseguirà con schedula- 
zione giornaliera. 



CREIAMO IL JOB 

Prima di tutto iniziamo utilizzano l'enterprise ma- 
nager per dare il via alla procedura di creazione. 











Generale | Passagg : ioni ' N atifiche | 




Data di creazione: 






Origine: (locai) 

} arget locale 
<" ■■ multipli: 




ChackUtentiS cadenza 




non ancora creato) 


W Attivato 


Categoria: 


[Sema rategoria (locale'!] 


A_\ 










Proprietario: 


CFll\Melo 


z\ 








Descrizione: 


C ;rtiolla utenti r scadenzai 




Data ultima modifica 


non pertinente) 


Cambia... 












OK | Annulla | Applica | ? 













Fig. 6: Creazione del Job 

Definiamo quindi il passaggio in cui viene richia- 
mata la stored procedure con il parametro impo- 
stato la prima volta a 15 e la seconda a 7 in modo 
da inviare la mail agli utenti in scadenza rispetti- 
vamente tra 15 e 7 giorni. Lo script T-SQL da inse- 
rire è il seguente: 

DECLARE @RC int 

DECLARE @numGiorni int 

SET @numGiorni = 15 

EXEC @RC = [test]. [dbo]. [checklnScadenza] @numGiorni 

SET @numGiorni = 7 

EXEC @RC = [test]. [dbo]. [checklnScadenza] @numGiorni 

ricordiamoci di cambiare il database. 



Generale | Avanzate | 



Nonne 
passaggio: 



checkU tenti nS cadenza) 




|ScriptTransact-SQL(TSQL) 


H 




[Test 


J 



@RCint 
DECLARE @numGiorniint 
SET @numGiorni = 15 

(™RC [test] [dbo] [checklnScadenza] SroniGioml 
SET QnunnGiorni = 7 

@RC [test] [dbo] [checklnScai lenza] @nurnGiorni 



< 



A 



v 



> 



Precedente 



Successivo Precedente 



I Annulla | | Applica | ? 



Fig. 7: Creazione dei Job 

Creiamo quindi una nuova pianificazione giorna- 
liera come indicato in Figura 7. A questo punto, 
clicchiamo su OK per salvare il Job. Da questo 
momento in poi il nostro JOB è impostato, sarà 
l'apposito servizio ad eseguirlo al momento 
opportuno 



lificazione 

Avvia automaticamente all'avvio di Agente SQI Servai 

Avvia :;.(« idc la CPU risulta inatl va 
r Una volta 
& Periodica 




Fig. 8: Creazione dei Job 



AUTOMAZIONE IHI SQL 
SERVER EXPRESS 

SQL Server Epress non include Y Agente e quindi 
non è possibile schedulare ijob come abbiamo vi- 
sto. Esiste comunque un workaround che sfrutta 
lo scheduler di Windows per simularne le funzio- 
nalità. 



1 



Come prima cosa creiamo una query che ese- 
gue la stored procedure 



DECLARE @RC int 



DECLARE @numGiorni int 



SET @numGiorni = 15 



EXEC @RC = [test]. [dbo]. [checklnScadenza] 

(cpnumGiorni 



SET (cpnumGiorni 
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EXEC @RC = [test].[dbo].[checkInScadenza] 

@numGiorni 

e salviamola ad esempio in c:\SQL_Manage\Query 
\checkUsers.sql. Esiste un eseguibile sqlcmd.exe 
che consente di eseguire dei comandi su SQL 
Server. La sintassi base per le funzionalità che ci 
interessano è: 

sqlcmd [-S server] [-i input file] 

Quindi per eseguire la query appena salvata ci ba- 
sta digitare: 



sqlcmd -S.\SQLExpress -i" c:\SQL_ 



Manage\Query 
\checkUsers.sql" 



4 Diamo un nome alla schedulazione ed impo- 
stiamone la periodicità l'orario di esecuzione e 
la data della prima esecuzione. 



Aggiungi e nificata 




Immettere un sione. Il nome 

può corrisp 



, .1 ■ - -, „ 

; 
Ogni settimana 
Ogni mese 
Una sola volta 

- , : i 




Con notepad creiamo un file in cui copiamo l'i- 
struzione vista sopra e salviamolo con nome 
c:\SQL_Manage\checkUsers. cmd. 
A questo punto passiamo alla creazione del task di 
Windows che si occuperà di eseguire il comando 
secondo le nostre esigenze. 

2 Dal pannello di controllo di Windows selezio- 
niamo "Scheduled Task" Facciamo doppio 
click sull'icona "Add Scheduled Task" e seguiamo 
la procedura guidata. 

" Aggiungi i sanificata 



Pianificazione guidata operazioni 



. , • • . ■ lette di pianificare 
l'esecuzio azione. 

: :: i :-:;;;-: *-:■: ' : • :. .." cu" : 

estabilita. 

Per contini.; e Avanti. 




Avanti > | Annulla 



) Come file da eseguire scegliamo c:\SQL_ Ma- 
I nage\checkUsers.cmd 



Aggiungi operazione pianificata 



Selezionare L'applicazione da pianificare 




Aggiungi operazione pianificata 




; ...... 

DM di avvio: 

| 1.00 jfe-| 

Esegui questa operazione: 

ogni giorno 
O ogni giorno feriale 

ogni 

Data di inizio: 



8 



Impostiamo infine la password e terminiamo 
la procedura. 



1 




^tefci. 


Immettere il nome e la password dell'utente. 

1 'o orazione verrà eseguita come se fosse stata 
avviata dall'utente specificato. 


Nome utente: D0MINI0\utente 


Password: •••••••• 




Conferma password: [••••••••| 


Senza una pass',- anificate 
potrebbero non essere eseguite. 










[ < Indietro \\ Avanti > J [ Annulla J 









CONCLUSIONI 

I JOB risultano molto utili in tutte quelle occasioni 
in cui si vuole automatizzare un compito di siste- 
ma. L'assenza di questa funzionalità in SQL Server 
Express rende la soluzione meno "pulita" tuttavia 
poter automatizzare i nostri lavori utilizzando 
questa tecnica renderà senza dubbio più semplice 
il nostro lavoro. 

Carmelo Scuderi 
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SISTEMA T H System. Collections.Generic 



LE CLASSI ED 

I METODI GENERICI 

I GENERICS SONO UNA NUOVA CARATTERISTICA INTERESSANTE DI VISUAL BASIC .NET 
2005, PERMETTONO DI RENDERE IL PROPRIO CODICE VELOCE, CONCISO E PIÙ 
ELEGANTE. SFRUTTIAMOLO A FONDO 





*4M.tìUMMUJUia 
t Conoscenze base di 
programmazione in 
VisualBasic.NET 

ì Windows 2000/XP. 
Visual Basic. NET 2005 



J J J 

vmm 



Tempo di realizzazione 



Gli insiemi generici, sono così definiti 
perché al momento della dichiarazio- 
ne si indica un segnaposto di tipo per 
gli oggetti contenuti invece di un tipo specifi- 
co. Agli oggetti contenuti nell'insieme, viene 
assegnato un tipo specifico solo quando si 
crea un'istanza della collezione. 
Le classi ed i metodi generici sono riutilizza- 
bili, indipendenti dai tipi e molto più efficaci 
rispetto alle rispettive controparti non generi- 
che. 

In pratica, i generics permettono di scrivere 
un blocco di codice, che si tratti di una classe 
collezione o di un metodo, che può operare 
con tipi differenti di argomenti. 
La versione 2.0 della libreria di classi di .NET 
Framework fornisce un nuovo spazio dei no- 
mi, System. Collections.Generic, che contiene 
numerose nuove classi collection generiche 
che possono essere specializzate per contene- 
re solo valori di un determinato tipo. 



CREARE UNA 

COLLEZIONE 

DI TIPI INTEGER 

Il modo più semplice per vedere come funzio- 
nano gli insiemi generici è tramite un esem- 
pio. Vediamo come si può definire una colle- 
zione che contenga solo valori di tipo integer: 

Dichiariamo la collezione colDilnteri 

Dim colDilnteri As New List(Of Integer) 

La nuova parola chiave O/specifica che il tipo 
generico List deve essere specializzato per 
operare con elementi di tipo Integer, e solo 
con questo tipo di elementi. 
Aggiungiamo due valori di tipo Integer con il 
solito metodo Add delle collezioni 

colDiInteri.Add(25) 
colDiInteri.Add(78) 



cicliamo su tutti gli oggetti presenti nella col- 
lezione con la classica struttura For Bach.. 
Next e mostriamo a video gli elementi della 
collezione 

For Each i As Integer In colDilnteri 

MessageBox.Show(i) 
Next 

Per leggere un elemento si usa la normale sin- 
tassi senza la necessità di operatori di conver- 
sione di tipo 

'Lettura di un elemento 



Dim elemento As Integer 



elemento = colDiInteri(O) 



MessageBox.Show(elemento) 

Con la parola chiave Of, abbiamo indicato che 
il tipo generico List deve essere specializzato 
per operare con elementi di tipo Integer, infat- 
ti, qualsiasi tentativo di aggiungere elementi 
di un tipo differente genera un errore di com- 
pilazione. Scrivendo il codice seguente: 

colDilnteri. Add("pippo") 

si ottiene Terrore: "Conversion from string 
"pippo" to type 'Integer' is not valid". 
Anche se non risulta evidente dal codice ap- 
pena scritto, la soluzione basata sui generics 
risolve il problema delle prestazioni, poiché la 
collection List(Of Integer) memorizza i suoi 
elementi in variabili Integer (o più in generale, 
in variabili del tipo specificato dalla clausola 
Of), perciò non si verifica più nessuna opera- 
zione di boxing. 

Complichiamo un pochino le cose, e suppo- 
niamo di avere una semplice classe Persona 
con due proprietà pubbliche, (mostrate come 
variabili pubbliche per brevità di scrittura del 
codice, ma non dimentichiamoci mai le buo- 
ne regole di una corretta programmazione ad 
oggetti) 
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Public Class persona 



Public Nome As String 



Public CodiceFiscale As String 



Public Sub New(ByVal NomePersona As String, 

ByVal CodiceFiscalePersona As String) 



Nome = NomePersona 



CodiceFiscale = CodiceFiscalePersona 



End Sub 



End Class 

È possibile dichiarare un elenco di persone 
mediante la classe List dell'insieme generico 
(List è la classe generica corrispondente a Ar- 
rayList), scrivendo il codice seguente: 

Dim Persone As New List(Of persona) 

Scrivendo questa singola riga di codice abbia- 
mo dichiarato una collezione tipizzata in mo- 
do sicuro, che memorizza solo i tipi persona e 
fornisce completo supporto IntelliSense sugli 
oggetti persona ivi contenuti. 
Per popolare la collezione di persone possia- 
mo scrivere il codice seguente: 

Dim Personal As New persona("Federica", 
"AAABBB21B88DQ86I") 

Persone. Add(Personal) 

Dim Persona2 As New persona("Sara", 
"AAABBB21K88D086I") 

Persone. Add(Persona2) 

Per mostrare a video le persone contenute 
nella collezione usiamo, come al solito, la 
struttura For Each..Next 

For Each Pers As persona In Persone 

MessageBox.Show("Nome: " & Pers. Nome & 

", CF: " & Pers.CodiceFiscale) 

Next 

Vb .Net 2005 mette a disposizione molti tipi ge- 
nerici, oltre all'oggetto List appena descritto: 

• Le collezioni generiche Dictionary(Of 
K,V) e SortedDictionary(Of K,V) permet- 
tono di creare insiemi hash a tipizzazione 
forte. Dictionary è la classe generica corri- 
spondente a Hashtable. 

• Collection è la classe generica corrispon- 
dente a CollectionBase. Collection può es- 
sere utilizzata come classe base, ma a dif- 
ferenza di CollectionBase non è una classe 
astratta ed è quindi molto più semplice da 
utilizzare. 



Dira col Di Interi Ab New Liat (Of Integer) 
colDilnteri . Add (25) 



jsclDi 
For E. 



PÌJPPO"); 

eger InV-nJni Jjel 
! . Inva 



MessageBcx. Show (i} 



'Lettura di un clemente 
Dira elemento A3 Integer 
elemento = colDilnteri (Q) 
MessageBcx . Show ( elemento } 

i Sub 

133 



InvalidCastException non è stata gestita 

Conversion from string 'pippo' to type 'Integer' is not valid. 

Suggerimenti per la risoluzione dei problemi: 

Per ulteriori informazioni vedere la proprietà InnerExcepbon. 

Quando si esegue il cast da un numero, il valore deve essere un numero inferiore a infinita, 

Assicurarsi che il tipo di origine sia convertibile nel tipo di destìnazmne. 

Visualizzare la Guida generale per questa eccezione, 

Visualizzare la Guida generale per l'eccezione interna, 

Cerca ulteriori infbrmaziani nella Guida in linea, . , 



Visualizza dettagli,,. . 

Copia dettagio eccezione negli v 



Fig.l 



ReadOnlyCollection è la classe generica 
corrispondente a ReadOnly CollectionBase. 
ReadOnlyCollection non è una classe 
astratta e dispone di un costruttore che 
semplifica l'esposizione di una classe List, 
esistente come insieme in sola lettura. 

Le collezioni generiche Stack(Of T), 
Queue(Of T) e LinkedList(Of T) si com- 
portano come normali elenchi e stack col- 
legati, fatta eccezione per il fatto che è 
possibile specificare quali tipi di oggetti vi 
saranno contenuti. Sono utili per creare 
una versione più robusta ed efficiente del- 
le altre comuni strutture dati. 



TIPI GENERIC 

Visual Basic 2005 ci permette di creare dei 
nostri tipi generic. Quando dobbiamo defini- 
re una classe generics, è necessario una ma- 
niera per differenziare un tipo generic come 
List(Of T), che contiene uno o più parametri 
di tipo, da un tipo generic come List (Of String) 
dove il parametro di tipo è stato sostituito (o 
collegato) ad un tipo specifico. 
Nel primo esempio si parla di definizione del 
tipo generic, tipo generic aperto o tipo generic 
non collegato. 

Nel secondo esempio si parla di tipo generic 
collegato. 

Scriviamo un piccolo pezzo di codice che ci 
permette di definire una semplice classe ge- 
nerica. 

Public Class ClasseGenerica(Of T) 

Public Campol As T 
End Class 

Possiamo notare, come il parametro generic T 
possa essere riutilizzato per definire o istan- 
ziare altri tipi generic. 



In tutti gli esempi di 
codice, per evitare di 
scrivere ogni volta il 
nome completo della 
libreria, assumiamo 
che le seguenti 
istruzioni di Imports 
siano utilizzate a livello 
di file o di progetto: 



Imports System 

.Collections 

Imports System 

.Collections.Generic 
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I generìcs non sono un 

concetto del tutto 

nuovo nel mondo della 

programmazione. 

Infatti, i generìcs sono 

simili ai template C++ , 

pertanto si potrebbe 

avere già familiarità se 

si è lavorato in 

precedenza con questo 

linguaggio. Tuttavia, i 

generìcs .NET hanno 

diverse caratteristiche 

e vantaggi che i 

template C + + non 

hanno, ad esempio i 

vincoli. 



Quando si crea un'istanza di una classe gene- 
rica, si indicano i tipi effettivi che andranno a 
sostituire i parametri di tipo. Il risultato è una 
classe indipendente dai tipi, che viene perso- 
nalizzata in base ai tipi specificati. 

Dim StrGenerica As New ClasseGenerica( 

Of String) 
StrGenerica. Campol = "Pippo" 
Dim IntGenerica As New ClasseGenerica( 

Of Integer) 



Public Partitalva As String 



IntGenerica. Campol = 10 



MessageBox.Show(StrGenerica. Campol) 
MessageBox.Show(IntGenerica. Campol) 

Un peculiare problema che ci troveremo ad 
affrontare lavorando con i generìcs, è che non 
è possibile fare concretamente alcuna ipotesi 
sul tipo che verrà passato come parametro del 
tipo generic. Ad esempio, il metodo New rice- 
ve un elemento di tipo generic T ma non può 
invocare alcun metodo di questo elemento, 
eccetto quelli ereditati da System. Object. Allo 
stesso modo, non è possibile utilizzare alcun 
operatore, compresi gli operatori matematici 
e di confronto, l'operatore 75, e l'operatore 
IsNot, senza che venga generato un errore di 
sintassi. Per ovviare a questi inconvenienti, ci 
vengono in aiuto i vincoli, come vedremo nel 
proseguo dell'articolo. 



GENERIC MULTIPLI 

Una caratteristica, non indifferente, delle 
classi generic è la possibilità di accettare più 
di un parametro generic. Possiamo, ad esem- 
pio, definire una semplice classe che permet- 
te di mettere in relazione tra di loro, due og- 
getti di un determinato tipo: 



Public Class MembroDi(Of TI, T2) 


Public ReadOnly Oggettol As TI 


Public ReadOnly Oggetto2 As T2 


Public Sub New(ByVal objl As TI, 


ByVal obj2 As T2) 


Oggettol = objl 


Oggetto2 = obj2 


End Sub 


End Class 



A questo punto utilizziamo la classe persona, 
definita in precedenza, e definiamo una nuo- 
va classe azienda che dovrà contenere alcune 
informazioni tipiche di una azienda: 

Public Class azienda 



Public Sub New(ByVal RagSoc As String, ByVal 

Piva As String) 



RagioneSociale = RagSoc 



Partitalva = Piva 



End Sub 



End Class 

La classe MembroDi permette di indicare per 
quale azienda lavora una determinata perso- 
na: 

Dim azl As New azienda( 

"GNSoft", "000000000") 

Dim persi As New persona( 

"Annamaria", "LLLBBB21K88D086I") 
Dim Dipendentel As New MembroDi( 

Of azienda, persona)(azl, persi) 
Dim pers2 As New persona( 

"Patrizia", "PPPBBB21K88D086I") 
Dim Dipendente2 As New MembroDi( 

Of azienda, persona)(azl, pers2) 

In una situazione reale, ci possiamo trovare di 
fronte alla necessità di gestire molte persone e 
molte aziende. Per questo motivo possiamo 
creare una collezione a tipizzazione forte che 
possa contenere oggetti di tipo MembroDi. 
Per ottenere questo risultato, si possono uti- 
lizzare più keyword Of nidificate, aumentando 
notevolmente la potenza dei generics: 

Dim Dipendenti As New List(Of MembroDi( 

Of azienda, persona)) 
Dipendenti. Add(Dipendentel) 
Dipendenti. Add(Dipendente2) 



OVERLOADING , 
ED EREDITARIETÀ 

In VB.Net 2005 è possibile definire tipi generic 
con lo stesso nome ma con un numero diffe- 
rente di parametri generic. Ad esempio, le tre 
classi scritte di seguito possono coesistere 
nello stesso namespace: 



Public RagioneSociale As String 



Public Class ClasseOverload 


'.... 


End Class 


Public Class ClasseOverload(Of T) 


"... 


End Class 


Public Class ClasseOverload(Of T, 


K) 


"... 



^ 102 /Giugno 2006 



http://www.ioprogrammo.it 



System. Collections.Generic ■ T SISTEMA 



End Class 

Questa caratteristica è simile all'overloading 
di un metodo, infatti, in fase di compilazione, 
VB utilizza la classe il cui numero di parame- 
tri generic corrisponde al numero di argomen- 
ti generic passati come parametro: 

Dim ci As ClasseOverload ' Una istanza della prima 

classe. 
Dim c2 As ClasseOverload(Of Long) ' Una istanza 

della seconda classe. 
Dim c3 As ClasseOverload(Of Long, Decimai) 

' Una istanza della terza classe. 

Da quello detto finora, sembrerebbe che un 
parametro generic possa essere utilizzato in 
qualsiasi punto di una classe, come se fosse 
un ordinario nome di tipo, ma questo non 
corrisponde al vero poiché esistono alcune 
eccezioni: 

• Non è possibile utilizzare un parametro 
generic nella clausola Inherits. In pratica, 
non si può derivare da un tipo passato co- 
me parametro generic. 

• Non è possibile utilizzare un parametro 
generic in una dichiarazione di attributo. 

• Non è possibile utilizzare un parametro 
generic per referenziare un'interfaccia nel- 
la clausola Implements. 

• È possibile derivare tipi generici dalla 
maggior parte delle classi base, nonché 
utilizzare vincoli per imporre la derivazio- 
ne di parametri di tipi generici da classi 
base, ma in questa versione di .NET Fra- 
mework non sono supportati i tipi generi- 
ci associati al contesto. 

• Non è possibile avere parametri di tipi ge- 
nerici nelle enumerazioni. 

• I metodi dinamici lightweight non posso- 
no essere generici. 

• È possibile creare un'istanza di un tipo ni- 
dificato in un tipo generico, solo se ai tipi 
sono stati assegnati i parametri di tipo re- 
lativi a tutti i tipi di inclusione. 



Public Sub New(ByVal az As azienda, ByVal pers 

As persona) 
MyBase.New(az, pers) 
End Sub 



oh i o iri 'o o 



End Class 



Public Class CoIRelazioneAziendaPersona 

Inherits List(Of RelazioneAziendaPersona) 
End Class 



METODI GENERIC 

VB 2005 permette di utilizzare la keyword Of 
persino nella definizione di un metodo. 
Possiamo, ad esempio, scrivere la seguente 
procedura: 

Public Sub Procedura(Of T)(ByVal Opl As T, ByVal 

Op2 As T) 



End Sub 

Si può invocare il metodo Procedura passando 
due variabili dello stesso tipo: 

Dim opl As Integer = 222 
Dim op2 As Integer = 444 
Procedura(Of Integer)(opl, op2) 

Nella maggior parte dei casi, si può invocare 
un metodo generic senza utilizzare la key- 
word Of, infatti il seguente codice funziona 
correttamente. 

Procedura (opl, op2) 

In alcuni casi è però necessario specificare la 
clausola Of, ad esempio quando i due argo- 
menti sono di tipo differente. In questi casi 
possiamo evitare l'errore di compilazione in 
due modi: possiamo convertire manualmente 
il secondo argomento allo stesso tipo del pri- 
mo argomento, oppure possiamo specificare 
la clausola OfneìY invocazione del metodo. 



iuiiìmi 



In tutte le applicazioni 
destinate alla versione 
2.0 è consigliabile 
utilizzare le nuove 
classi di insiemi 
generiche anziché 
le controparti non 
generiche meno 
recenti, quale Array List 



Il primo limite, vieta quindi di ereditare un ti- 
po da un altro tipo definito per mezzo di un 
parametro generic, però questo non ci vieta, 
tuttavia, di utilizzare un tipo generic nella 
clausola Inherits, come vuole la prassi comu- 
ne. Ad esempio, si possono definire le seguen- 
ti due classi che sono basate sul tipo 
MembroDi definito in precedenza: 

Public Class RelazioneAziendaPersona 
Inherits MembroDi(Of azienda, persona) 



INSIEMI GENERICI 



Gli insiemi generici consentono di 
ottenere notevoli risparmi di 
tempo. Chiunque abbia creato 
insiemi personalizzati conosce la 
quantità di codice che può essere 
necessaria. Gli insiemi generici in 
Visual Basic permettono di creare 
in una riga di codice l'equivalente 



di un insieme personalizzato. 
Non è più necessario creare insiemi 
personalizzati separati per ciascun 
tipo di oggetto da memorizzare. 
È sufficiente fornire il tipo 
desiderato nel momento in cui 
viene creata l'istanza dell'insieme 
generico. 
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VINCOLI GEMERIC 

Supponiamo di voler scrivere un metodo ge- 
neric, che restituisca il valore più basso dei 
parametri passati come argomenti in un ar- 
ray, la classica funzione che calcola il minimo: 



Public Function Min(Of T)(ByVal ParamArray 

values() As T) As T 


Dim risultato As T 


= values(O) 


For i As Integer = 


1 To UBound(values) 


If values(i) < r 


sultato Then risultato = 

values(i) 


Next 


Return risultato 


End Function 



Come si può vedere in figura, l'operatore < 
(minore di) provoca un errore di compilazio- 
ne, poiché il compilatore non può fare con- 
cretamente alcuna ipotesi sul tipo che verrà 
passato come parametro del tipo generic, e 
quindi non può essere sicuro che questo me- 
todo verrà utilizzato solo con tipi che suppor- 
tano questo operatore. 



TERMINI E DEFINIZIONI RELATIVI 
Al GENERICS 



Il termine generics viene utilizzato 
per indicare classi, strutture, inter- 
facce e metodi dotati di segnaposto 
(parametri di tipo) per uno o più ti- 
pi contenuti o utilizzati in tali ele- 
menti. Una classe di insiemi generi- 
ci può utilizzare un parametro di ti- 
po come segnaposto per il tipo di 
oggetti in essa contenuti. I parame- 
tri di tipo appaiono come tipi dei 
campi e come tipi di parametri dei 
metodi della classe. Un metodo ge- 
nerico può utilizzare il relativo pa- 
rametro di tipo come tipo del valo- 
re restituito o di uno dei relativi pa- 
rametri formali. 

Una definizione di tipo generico è 

una dichiarazione di classe, struttu- 
ra o interfaccia che funge da mo- 
dello, con segnaposto per i tipi che 
può contenere o utilizzare. La classe 
Dictionary, ad esempio, può conte- 
nere due tipi: chiavi e valori. 
Dal momento che si tratta solo di 
un modello, non è possibile creare 
istanze di una classe, struttura o in- 
terfaccia che sia una definizione di 
tipo generico. 

I parametri di tipo generico, o pa- 
rametri di tipo, sono i segnaposto 
presenti in un tipo generico o in 
una definizione di metodo. 

Un tipo generico costruito, o tipo 



costruito, è il risultato della specifi- 
ca di tipi per i parametri di tipo ge- 
nerico di una definizione di tipo ge- 
nerico. 

Un argomento di tipo generico è 

qualsiasi tipo utilizzato in sostitu- 
zione di un parametro di tipo gene- 
rico. 

Il termine generale "tipo generico" 
include sia tipi costruiti sia defini- 
zioni di tipo generico. 
I vincoli sono limiti imposti su para- 
metri di tipo generico, è ad esem- 
pio possibile limitare un parametro 
di tipo ai tipi che implementano 
l'interfaccia generica IComparer per 
garantire la possibilità di ordinare 
le istanze del tipo. È inoltre possibi- 
le vincolare i parametri di tipo a ti- 
pi che hanno una determinata clas- 
se base, hanno un costruttore pre- 
definito oppure sono tipi di riferi- 
mento o tipi di valore. 
Gli utenti del tipo generico non 
possono utilizzare in sostituzione 
argomenti di tipo che non 
soddisfano i vincoli. 
Una definizione di metodo generico 
è un metodo con due elenchi di pa- 
rametri, ossia uno di parametri di 
tipo generico e uno di parametri 
formali. I parametri di tipo possono 
apparire come tipo restituito o co- 
me tipi dei parametri formali. 



Come abbiamo visto in precedenza, questo è 
un problema tipico che si verifica quando si 
lavora con i generics, che si può aggirare ap- 
plicando un vincolo sul tipo T. Nel nostro ca- 
so, ad esempio, possiamo imporre che il me- 
todo debba essere invocato solo con tipi che 
supportano l'interfaccia IComparable. Le in- 
terfacce generiche IComparer e lEquality- 
Comparer consentono di definire un confron- 
to di ordinamento o di uguaglianza e forni- 
scono un sistema per ridefinire tali relazioni 
nel caso di tipi che implementano l'interfac- 
cia in questione. Possiamo scrivere: 

Public Function Min(Of T As IComparable)(ByVal 

ParamArray values() As T) As T 

End Function 

Poiché abbiamo imposto che T debba esporre 
l'interfaccia IComparable, il codice nel meto- 
do può invocare con sicurezza il metodo 
CompareTo per calcolare il valore più basso 
tra quelli passati come argomento: 

Public Function Min(Of T As IComparable)(ByVal 

ParamArray values() As T) As T 
Dim risultato As T = values(O) 
For i As Integer = 1 To UBound(values) 

If risultato. CompareTo(values(i)) > Then 

risultato = values(i) 

Next 

Return risultato 
End Function 

Per utilizzare la funzione Min si può scrivere il 
seguente codice dove non è necessario speci- 
ficare la clausola O/nella invocazione del me- 
todo 

MessageBox.Show(Min(25, 10, 65)) 'Visualizza 10 

Visual Basic 2005 supporta cinque tipi di vin- 
coli: 

• Vincolo di interfaccia: l'argomento tipo deve 
implementare l'interfaccia specificata. 

• Vincolo di ereditarietà: l'argomento tipo 
deve derivare dalla classe base specificata. 

• Vincolo di classe: l'argomento tipo deve 
essere un tipo reference. 

• Vincolo di struttura: l'argomento tipo 
deve essere un tipo value. 

• Vincolo New: l'argomento tipo deve 
esporre un costruttore senza parametri (di 
default). 

Luigi Buono 
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Microsoft SQL 
Express Edition 

PER LA PRIMA VOLTA IN VERSIONE GRATUITA, ARRIVA IL DB PER LE AZIENDE 




Microsoft SQL server 2005 è la nuova 
versione del database progettato da 
Microsoft per rispondere alle esigenze 
di tipo professionale. Le novità intro- 
dotte sono veramente moltissime. 
Prima fra tutte spicca il nuovo formato 
file: "MDF". Con questa nuova versio- 
ne i dati possono essere salvati in un 
file esterno, con estensione MDF. 
Questo approccio, molto simile a quel- 
lo usato da Access con i suoi MDB, 
rende incredibilmente elevata la porta- 
bilità da una macchina all'altra. 
Ulteriori novità importanti sono state 
introdotte come ad esempio i Service 
Broker, che consentono di salvare i dati 
in una coda del SQL Server locale ed 
effettuare un update sul server remoto 
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in modo automatico alla prima dispo- 
nibilità della connettività, e ancora gli 
Integration Services grazie ai quali è 
possibile migrare da qualunque data- 
base esterno anche proprietario a SQL 
Server, adottando un linguaggio di tra- 
sformazione interno, appunto 
Integration Services. 
La versione Express che qui presentia- 
mo è una versione completa, limitata 
all'uso di 4GB di dati e un GB di Ram, 
inoltre non è possibile utilizzare le fun- 
zionalità di reportistica, il service 
broker, e gli IS. Tuttavia rappresenta 
un'ottima soluzione per lo sviluppo di 
un gran quantitativo di applicazioni e 
può tranquillamente essere utilizzata 
anche in fase di produzione 



AJAX FOR .NET 

IL FRAMEWORK PER CREARE 
APPLICAZIONI AJAX IN AMBIENTE 
MICROSOFT 

Ajax è una tecnologia che si sta rapida- 
mente affermando nel campo delle 
WEB Application. Consente di realiz- 
zare pagine web dinamiche in grado di 
aggiornare solo le parti variabili della 
pagina senza doverla ricaricare intera- 
mente. Ovviamente questo comporta 
un vantaggio immediato in termini di 
usabilità delle applicazioni, tale che le 
web application possono assumere il 
comportamento tipico in termini di 
interfaccia, di un'applicazione standa- 
lone 
Directory: /ajaxfornet 



ASPECT C++ 

PROGRAMMARE AD ASPETTI 
CON C++ 

La programmazione ad Aspetti nasce 
dall'esigenza di riunire insieme molti 
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"spezzoni" di programmi diversi, un 



po' come avveniva con la program- 
mazione procedurale ma più legata 
agli eventi. Consente di definire dei 
JointPoints a cui viene passato il con- 
trollo in relazione ad un evento spe- 
cifico. Questa libreria consente 
appunto di adottare questo approc- 
cio anche con software scritto in C++ 
Directory: /aspectcpp 

AVICREATOR 1.5 

PER CREARE PICCOLE ANIMAZIONI 
DA INSERIRE NEI PROPRI PRO- 
GRAMMI 

Un utility di corredo, comoda nel caso 
in cui si vogliano rendere più eleganti le 
proprie applicazioni aggiungendovi 
elementi di feedback multimediali. Per 
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esempio è possibile con questa utility 
creare facilmente l'animazione dell 
classico file che viaggia da una cartella 
all'altra, o altre animazioni del genere, 
che certamente non influiscono sulla 
sostanza dell'applicazione ma la rendo- 
no più fruibile e certamente più curata 
Directory: Avicreator 

AXIS 1.3 

IL FRAMEWORK PER LA 
CREAZIONE DI WEB SERVICES IN 
JAVA 

Ormai la programmazione distribui- 
ta avviene quasi esclusivamente per 
mezzo di Web Services. Chi però ha 
provato a realizzarne qualcuno in 
Java, ha scoperto che la tecnica non è 
così semplice. Con Axis tutto diventa 
meno complesso, interfacce sempli- 
ficate per la creazione dei WSDL, per 
la gestione e il deployment del WS 
rendono comoda la programmazione 
in Java anche per questa tipologia di 
applicazioni. Un must per chi adotta 
la programmazione distribuita 
Directory: /Axis 

BAMBOO 1.4.4 

IL TOOL PER LA PREVALENZA 
IN .NET 

Di prevalenza ne abbiamo parlato 
ampiamente negli scorsi numeri di 
ioProgrammo. Si tratta di una tecnica 
che implementa un approccio nuovo 
all'uso dei database. In sostanza i dati 
non vengono realmente salvati sul- 
l'hard disk ma mantenuti in memoria, 
tutte le operazioni vengono ricordate a 
mezzo di log. Con l'ampliamento della 
memoria disponibile questo genere di 
tecnica sta diventando ormai di uso 
comune e consente una velocità ecce- 
zionale d'accesso e update dei dati 
rispetto alle tecniche tradizionali, di 
fatto tutte le operazioni avvengono in 
Ram con l'aumento di velocità che è 
facile aspettarsi. 
Directory:/ Bamboo 

BUGTRACKER.NET 
2.2.4 

PER TENERE SEMPRE SOTTO 
CONTROLLO I BUG IN FASE DI 
PRODUZIONE 

Molti di voi avranno avuto di utilizza- 
re qualche volta un "bugzilla". Si trat- 
ta di un'applicazione Web grazie alla 



quale gli utenti possono segnalare un 
eventuale difetto di funzionamento 
riscontrato in un software in fase di 
utilizzo. Bugtracker.NET nasce con lo 
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stesso scopo, ma si tratta, ovviamen- 
te di un'applicazione interamente 
funzionante in ambienti Microsoft. 
Tramite questo tipo di tecnica è faci- 
lissimo gestire la cronologia e anche 
l'importanza dei bug, in modo da 
aumentare la facilità di creazione 
degli upgrade. 
Directory:/ Bugtracker 

COMMANDBAR 
FOR .NET 

UNA LIBRERIA PER ESTENDERE LE 
WINDOWS FORM 

Un controllo aggiuntivo che consente 
di implementare all'interno di una 
Form anche una CoolBar, menu dotadi 
di Bitmap e context Menu molto parti- 
colari. Utile per rendere ancora più 
interessanti le proprie applicazioni. 
Directory:/ CommandBar 

DEV C++ 4.9.9.2 

L'IDE PIÙ USATO DAI 
PROGRAMMATORI C++ 

Semplice, leggero, completo, Dev 
Cpp è sicuramente uno degli 
ambienti più amato da chi sviluppa 
in C++. Supporta MingGW ma con 
poche modifiche è possibile adottar- 
lo anche con un compilatore .NET. 
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Dotato di code complexion e syntax 
higlighting, sicuramente si pone 
come un valido aiuto per tutti coloro 
che sviluppano progetti anche di 
grandi dimensioni. 
Directory: /DevCPP 

DOTLUCENE 1.4.3 

IL SEGUGIO TROVA TUTTO 

Una delle librerie che ha attratto l'at- 
tenzione dei programmatori di tutto 
il mondo nell'ultimo anno è Lucene. 
Si tratta di una libreria che consente 
di indicizzare in modo ottimale il 
contenuto di un Hard Disk per poi 
poter effettuare delle ricerche molto 
veloci sull'indice. Lucene è stata uti- 
lizzata in 
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progetti di grandi dimensioni come 
ad esempio Beagle. Ne esiste anche 
un porting in ambiente .NET che è 
appunto quello che vi presentiamo. 
Utilissima in tutti quei casi in cui si 
vogliano dotare le proprie applica- 
zioni di funzioni di ricerca "libera" 
sui contenuti di un supporto o su una 
parte di esso. 
Directory: /Dot Lucene 

DRUPAL 4.7.3 RC3 

LA RELEASE CANDIDATE 3 DI UNA 
DELLE PIATTAFORME PER BLOG 
PIÙ DIFFUSE 

Il fenomeno dei Blog ha cambiato 
radicalmente la struttura di Internet. 
Drupal è una delle piattaforme che 
più di ogni altra si è distinta nella 
capacità di offrire all'utente un'inter- 
faccia comoda a supporto di funzio- 
nalità molto complesse. D'altra parte 
mette a disposizione del programma- 
tore una serie di API tale che svilup- 
pare un modulo per estenderne le 
funzionalità diventa divertente oltre 
che flessibile. Si tratta dunque di una 
web application che farà ancora par- 
lare di se, e sopratutto garantisce agli 
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sviluppatori di poterla personalizza- 
re in modo molto efficace per le pro- 
prie esigenze 
Directory:/ Drupal 

ECLIPSE 3.1.2 

L'IDE TUTTOFARE 

Dalla sua parte un'enorme flessibilità. 
L'IDE multipiattaforma più utilizzato 
dai programmatori java, grazie alla sua 
modularità, sta diventando in breve 
tempo il punto di riferimento per una 
larga schiera di sviluppatori. 



- ? Li-Li" 11 r 



|SK 



~" L 3f*Z"WUtiJlÈìitf— •*— - " 



Attualmente esistono plugin per svilup- 
pare in PHP, per la progettazione di 
WEB Services, per l'integrazione in 
Hibernate ed addirittura si stanno stu- 
diando soluzioni per Actionscript.- 
Eclipse si propone come un'ambiente 
ormai solido e maturo, pronto per esse- 
re utilizzato in ogni ambito della pro- 
grammazione 
Directory:/ Eclipse 

ECLIPSE ME 

LO SVILUPPO MOBILE SECONDO 
ECLIPSE 

EclipseME è un plug-in per Eclipse 
che vi aiuta nella creazione di una 
MIDlet. Una Midlet è tipicamente un 
programma in grado di girare su 
dispositivi mobili. Eclipse ME aiuta 
sia nello sviluppo sia nel deployment 
garantendo una maggiore facilità 
nella programmazione 
Directory:/ EclipseME 

FREETTS 1.1.2.1 

UN SINTETIZZATORE VOCALE 
SCRITTO INTERAMENTE IN JAVA 

A freeTTS abbiamo dedicato ampio 
spazio nei numeri precedenti di 
ioProgrammo. Si tratta di un motore 
sintesi vocale interamente scritto in 
Java. Dove per sintesi vocale si inten- 
de che questo engine consente di 
creare applicazioni Java in grado di 



produrre dei suoni molto simili alla 
voce umana. Utile ad esempio per 
farvi leggere le email, oppure un rac- 
conto, la quantità di applicazioni 
disponibili dipende solo dalla vostra 
fantasia 
Directory:/ FreeTTS 

GSOAP C++ 

UNA LIBRERIA PER SCRIVERE WEB 
SERVICES IN C++ 

Web Services per .NET per Java, per 
PHP, ma se ne volessimo scrivere uno 
in C++? Arriva Gsoap, che appunto ci 
semplifica la vita in questo compito. 
Supporta interamente SOAP e la 
creazione del WSDL. Si tratta di una 
libreria piuttosto avanzata, anche se 
ancora in fase embrionale. Non le 
mancano tuttavia le potenzialità per 
diventare un prodotto di enorme 
successo 
Directory:/ Gsoap 

HIBERNATE 3.2.0 

IL TOOL PER LA PERSISTENZA DEI 
DATI IN JAVA 

I programmatori sono abituati a pen- 
sare in termini di classi ed oggetti. 
Non c'è programma che prescinda 
ormai dalla logica della programma- 
zione OOP. Tuttavia i database SQL 
ragionano ancora in termini di puro 
linguaggio, non c'è nessuna correla- 
zione fra un dato e l'oggetto che lo 
rappresenta. Hibernate aggira questo 
ostacolo, ponendosi come fra- 
mework che maschera un database 
relazionale con una logica OOP. 
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In questo modo i programmatori Java 
possono ad esempio accedere a un 
qualunque database pensando alle 
righe e alle colonne che lo rappresen- 
tano in termini di oggetti e non di 
entità relazionali. Quella che vi pre- 
sentiamo in questo numero è la ver- 



sione più aggiornata del tool, più 
veloce e affidabile 
Di recto ry:/H ibernate 

IRRLICHT LO 

ACCENDI IL MIGLIOR MOTORE 3D 
OPEN SOURCE! 

IrrLicht è un motore per la grafica tri- 
dimensionale, scritto in C++ e utiliz- 
zabile sia con questo linguaggio, sia 
con i linguaggi di .NET. Presenta le 
principali caratteristiche che si trova- 
no anche nei motori professionali e 
vanta una notevole comunità di svi- 
luppatori, con diversi progetti in atti- 
vo. Irrlicht è sicuramente molto velo- 
ce, flessibile e in grado di gestire 
mesh provenienti da diversi ambien- 
ti. In ioProgrammo più volte abbia- 
mo proposto articoli completi che 
mostravano l'utilizzo di questo ecce- 
zionale engine per lo sviluppo di 
videogames 
Directory:/ Irrlicht 

J2SE 1.5.0 UPDATE 6 

L'SDK ESSENZIALE PER LA 
PROGRAMMAZIONE JAVA 

Se siete dei programmatori Java o 
aspirate a diventarlo non potete 
mancare di installre il J2SE di Sun, al 
cui interno è contenuto il compilato- 
re nonché tutte le librerie essenziali 
per potere programmare in Java. 




Quella che vi presentiamo è l'ultima 
release aggiornata del compilatore 
che copre molti bachi di programma- 
zione e si presenta leggermente più 
veloce. 
Directory:/ J2SE 

JAMELEON 3.2 

UN FRAMEWORK 
AUTOMATIZZATO PER IL TESTING 
DELLE APPLICAZIONI 
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Jameleon è un tool che consente di 
testare con efficacia il software da voi 
creato. Il concetto principale su cui 
Jameleon si basa è quello de Tag che 
rappresentano una schermata del- 
l'applicazione. Ciascun gruppo di 
Tag può essere parametrizzato con 
dati e chiaramente deve restituire un 
certo output. Infine tutto può essere 
automatizzato producendo degli 
script che salvano i risultati in file di 
log 
Directory:/ jameleon 

JASPER REPORTS 
1.2.1 

CREA I TUOI REPORT A PARTIRE 
DA APPLICAZIONI JAVA 

Forse il miglior tool per la creazione 
di reportistica da associare ad appli- 
cazioni Java. Consente di creare rap- 
porti in formato PDF, HTML, XLS, 
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CSV e XML. Si tratta di un tool com- 
plesso ma anche molto efficace che 
affianca uno strumento per la crea- 
zione dei report a sofisticate API che 
possono facilmente interfacciarsi 
con le vostre applicazioni 
Directory: /JasperReports 

JDEBUG TOOL 

UN DEBUGGER PER JAVA FULL 
OPTIONAL! 

Un debugger standalone costruito 
sulla base della JPDA, Java Platform 
Debugger Architecture. L'interfaccia 
grafica ed un Help ottimamente 
strutturato consentono un rapido 
utilizzo del tool. Tra le funzioni 
segnaliamo: debug remoto, debug 
multi-thread, modifica delle variabili 
"al volo", visualizzazione delle classi 
attualmente caricate, valutazione dei 
toString, monitoraggio dell'occupa- 
zione di memoria, sincronizzazione 



con gli eventi di load e unload delle 
classi. In questa versione si apprezza 
particolarmente la velocità di esecu- 
zione. 
Directory:/ Jdebugtools 

JEDIT 4.2 

L'EDITOR LEGGERO PER 
PROGRAMMATORI JAVA 

Realizzato completamente in Java, jEdit è 
un completo editor di testi per program- 
matori disponibile per numerose piat- 
taforme tra cui MacOS X, OS/2, 
GNU /Linux (Unix) e Windows. Il pro- 
gramma, per l'immediatezza e la sempli- 
cità di utilizzo, è molto usato per scopi 
didattici e da programmatori non profes- 
sionisti. 
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jEdit integra un completo linguaggio di 
macro e dispone di un'architettura facil- 
mente estensibile mediante l'utilizzo di 
numerosi plugin facilmente gestibili tra- 
mite il "plugin manager". Inoltre, nono- 
stante sia stato creato per sviluppare pre- 
valentemente applicazioni Java, dispone 
di funzionalità per indentare ed eviden- 
ziare il codice per oltre ottanta linguaggi 
di programmazione. Per poter installare e 
utilizzare jEdit è necessario disporre del 
J2SDK 1.3 ol.4. 
Directory:/ Jedit 

JGAP 2.6 

LA LIBRERIA PER GLI ALGORITMI 
GENETICI 

Gli algoritmi genetici rappresentano un 
campo in continua evoluzione. Si tratta di 
una metodologia che consente di svilup- 
pare soluzioni evolutive sulla base di 
combinazioni cromosomiche. La realtà è 
meno complessa delle parole utilizzate 
per descriverla, sostanzialmente si parte 
da una popolazione di soluzioni che ven- 
gono rimescolate simulando l'evoluzione 
del patrimonio genetico, dal 



nuovo nucleo di soluzioni si estrapolano 
quelle migliorative delle precedenti e si 
continua così fino alla completa risolu- 
zione del problema. jGap è una libreria 
Java che mette a disposizione diverse pri- 
mitive proprio per la gestione degli algo- 
ritmi genetici, che ormai trovano applica- 
zione in più di un settore. 
Directory:/ Jgap 

JOOMLA 1.0.8 

L'EREDE DI MAMBO 

Molti di voi conosceranno Mambo, si 
tratta di uno dei CMS più utilizzati in 
rete. A costruire il successo di Mambo è 
stata la sua alta modularizzazione, la 
capacità di consentire agli 
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utenti di personalizzare il sistema con 
poche, rapide operazioni, la completez- 
za del sistema. Peccato che recentemen- 
te gli sviluppatori di Mambo si siano tro- 
vati n disaccordo con le scelte di Mirò la 
software house che ha prodotto il 
software fino ad ora. Così molti di loro 
hanno abbandonato Mirò e hanno dato 
vita a Joomla l'erede di Mambo. Basato 
sul suo stesso codice ma con la promes- 
sa di essere OpenSource ora come nelle 
future versioni. 
Directory:/ Joomla108 

JUHIIT 3.8.2 

PER TESTARE FACILMENTE 
PROGRAMMI JAVA 

Uno dei tool fondamentali per proce- 
dere al testing di programmi privi di 
Bug. Junit consente di creare test 
automatizzati che possono mettere 
sotto stress le vostre applicazioni e 
creare report affidabili che vi consen- 
tono di intervenire in modo efficace 
su ogni eventuale bug 
Directory:/ Junit 
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ALBERI DI RICERCA 

LA STRUTTURA DATI ALBERO È UNA DELLE PIÙ IMPORTANTI NEL PANORAMA 
DELLA PROGRAMMAZIONE. IN QUESTO ARTICOLO IMPAREREMO COME GESTIRE AL 
MEGLIO LE TECNICHE CHE NE REGOLAMENTANO IL FUNZIONAMENTO 




Una delle ragioni per le quali si applica un 
criterio di ordinamento ad una serie di da- 
ti è quella di voler successivamente ese- 
guire su questa serie delle ricerche rapide. Con in- 
siemi di dati disordinati si può procedere alla ricer- 
ca soltanto in modo del tutto sequenziale, ovvero 
esaminando i dati uno dopo l'altro, a partire dal pri- 
mo, fin quando non si trova quello cercato. Vicever- 
sa nel caso in cui una serie di dati sia stata in qualche 
modo ordinata si può applicare una ricerca binaria. 
Con tale metodo i tempi di computazione si abbat- 
tono. La logica di esplorazione binaria delle infor- 
mazioni ha introdotto la necessità di costruire delle 
strutture dati a cui questo tipo di attività si adatti fa- 
cilmente. Sono così stati introdotti gli alberi, ogget- 
to della presente esposizione, strutture dati solita- 
mente implementate in modo dinamico. I campi di 
applicazione sono tanti, si pensi al backtracking e a 
molti algoritmi ricorsivi; la soluzione in tale ambito 
non è altro che un nodo da ricercare all'interno di 
un albero. Molti metodi della ricerca operativa fan- 
no riferimento ad alberi, a titolo esplicativo vale bran- 
di and bound. E, senza andare lontano, si faccia ri- 
ferimento al radixsort oggetto delle nostre attenzio- 
ni nello scorso appuntamento. E così si potrebbe 
continuare a lungo. Ad ogni modo nel corso dell'ar- 
ticolo faremo alcuni esempi. 



di eliminato una metà di array. Il metodo prosegue 
applicando lo stesso procedimento alla parte di 
array rimasta. Rapidamente, al più in lg(n) passag- 
gi, la ricerca termina. Per l'implementazione sarà 
sufficiente mantenere tre indici. I primi due che 
chiameremo inizio e fine circoscrivono il vettore 
parziale che iterazione dopo iterazione si dimezza; 
il terzo: centro, indica l'elemento da confrontare 
con x. Ecco il codice C++. 



// 



Dichiarazione 



// ... input del vettore 



// .... Ordinamento del vettore 



cout<<"\n x 



cin>>x; 



inizio=l; 



fine=n; 



trovato=false; 



while ((! trovato) && (inizio<=fine)) 



{ centro=(inizio+fine)/2; 



if (vettore[centro] = =x) trovato =true; 
else if (vettore[centro]>x) fine=centro-l; 
else inizio=centro+l; 



>; 



if (trovato) cout<<"\n il nome è presente in 

posizione "<<centro; 
else cout<<"il nome non è presente"; 



// 




9 Basidi 
1 programmazione C++ 




RICERCA BINARIA 

Assumiamo che un insieme di n dati sia struttura- 
to come array ordinato. È possibile applicare una 
ricerca binaria con il risultato di ottenere al più 
lg(n) confronti, con Ig logaritmo in base 2. Nel caso 
della ricerca sequenziale, ossia il confronto in se- 
quenza dal primo elemento fino a quello che si in- 
tende trovare, si devono fare nel caso peggiore n 
confronti. Il metodo è semplice. Si divide l' array a 
metà e si confronta l'elemento x che si vuole cerca- 
re con l'elemento centrale dell' array. Se sono ugua- 
li siamo stati molto fortunati, e la ricerca è conclu- 
sa, altrimenti si procede con l'analisi del confronto 
dei due elementi. Se x è minore dell'elemento cor- 
rente dell' array vuol dire che il valore cercato si 
trova nella metà inferiore dell' array, altrimenti an- 
cora, l'elemento sarà collocato nella metà superio- 
re dell' array. Con un solo confronto abbiamo quin- 



La logica binaria di tale ricerca ha contribuito alla 
costruzione di strutture particolari che mettono 
ancora in risalto le capacità elaborative di questo 
pur semplice metodo, in particolare: gli alberi. 



DEFINIZIONE DI ALBERO 

L'albero è una importante e molto usata struttura 
dati. Usualmente viene implementato con compo- 
nenti dinamiche costituite da nodi che contengo- 
no puntatori. In particolare un albero è costituito 
da nodi. Ogni nodo contiene una parte informati- 
va e dei collegamenti verso altri nodi. Ogni nodo 
può quindi avere dei nodi discendenti anche chia- 
mati figli e nodi di riferimento padre di cui è ap- 
punto discendente. L'intera struttura è identificata 
da un nodo origine chiamato radice. L'analogia 
con il vero albero, appartenente al mondo vegeta- 
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le per intenderci, è sempre presente. I nodi termi- 
nali che non hanno figli sono le foglie. Tutti gli altri 
sono nodi intermedi o semplicemente nodi. La 
struttura è organizzata per livelli. Al livello zero tro- 
viamo la radice. I discendenti della radice sono a 
livello uno. I figli dei figli della radice sono a livello 
due e così via. Man mano che si scende verso livel- 
li maggiori si ha un aumento esponenziale del 
numero dei nodi. 

Ecco una definizione ricorsiva di livello: "il livello di 
un nodo in un albero è pari a 1 più il livello del nodo 
padre, intendendo che la radice ha livello 0". 
Il numero massimo di nodi per livello si ha quan- 
do tutti i nodi hanno il massimo dei figli tale nu- 
mero è: m A n. Il termine m è definito come grado 
dell'albero, ovvero il numero massimo di nodi 
discendenti da un generico nodo, n è il livello. Il 
grado di un nodo è il numero di nodi discendenti 
da esso. Il tipo di albero più usato afferisce al grado 
due e si tratta proprio dell'albero binario, oggetto 
dei nostri approfondimenti. Non vanno comun- 
que trascurati altri tipi di alberi che hanno grado 
maggiore; il conosciuto B-tree usato nell'ambito 
dell'indicizzazione dei file ha grado maggiore di 2. 
Diamo una definizione formale di albero. Ci ser- 
virà in seguito per comprendere alcune funzioni di 
manipolazione. Un albero è: 

1. Una struttura vuota. 

2. Un nodo di tipo A 

3. Un determinato numero di sottoalberi riferiti 
ad un nodo di tipo A, i sottoalberi sono degli al- 
beri. 

Il terzo punto evidenzia la natura ricorsiva dell'al- 
bero. Occorre precisare che con il termine "riferito" 
si intende un collegamento da un nodo padre ver- 
so il nodo soggetto. 



ALBERO BINARIO 

L'albero in cui i nodi hanno il grado due, è detto 
binario. In tal caso il numero massimo di nodi è 2 n 
con n livelli. Formula ricorrente questa per i pro- 
grammatori! L'albero binario è il più usato non so- 
lo perché è strettamente relazionato alla ricerca bi- 
naria ma anche per altre applicazioni. Ad esempio, 
le espressioni matematiche e logiche trovano una 
naturale descrizione alberi binari. In Figura 1 so- 
no mostrate due espressioni logiche rappresentate 
da altrettanti alberi binari. Il particolare albero bi- 
nario che sarà oggetto dei nostri approfondimenti 
è detto di ricerca. Si tratta di un albero in cui le in- 
formazioni vengono collocate nei singoli nodi in 
modo ordinato. Significa che per un qualsiasi nodo 
il discendente destro avrà rispetto ad esso un con- 
tenuto informativo minore, mentre il nodo sinistro 
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Fig. 1: Alberi binari che esprimono te due espressioni condizionali: 1- A>B; 2- 
((X=10) AND (Z<B)) OR (A=B) 



maggiore. Una struttura così costruita garantisce la 
ricerca binaria. Nella classe C++ che svilupperemo 
introdurremo i metodi fondamentali per la mani- 
polazione degli alberi e si porrà il problema di co- 
me esplorarli. Esistono tre modi. A seconda dell'or- 
dine di visita. Vedremo tutti e tre i metodi. Il preor- 
dine visita in ordine: la radice, il sottoalbero sini- 
stro e il sottoalbero destro. Il inordine visita in se- 
quenza: il sottoalbero sinistro la radice e il sottoal- 
bero destro. Il postordine ha come successione di 
visite: il sottoalbero sinistro, il sottoalbero destro e 
la radice. Rispetto all'albero di Figura 2 i metodi di 
visita producono i seguenti risultati: 



1. preordine: lillo, huggy, mary, molly, navy; 

2. inordine: huggy, lillo, mary, molly, navy; 

3. postordine: huggy, molly, navy, mary, lillo. 

Tutti i metodi hanno le proprie peculiarità, ad 
esempio il metodo inordine o simmetrico visualiz- 
za le informazioni in ordine come il nome stesso ci 
suggeriva; purché si tratta di un albero di ricerca. 



ALBERO 
COME GRAFO 

Un albero è un grafo 
orientato costituto da 
nodi collegati a altri 
nodi discendenti detti 
figli. Per il discendente 
il nodo generatore è 
padre. Tutti i nodi 
hanno figli tranne le 
foglie e tutti i nodi 
hanno padri tranne il 
nodo generatore 
radice. 




Fig. 2: Alberi binari e metodi di esplorazione 
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GLOSSARIO 



ALBERO AVL 

È un particolare albero 

binario bilanciato che 

ha la caratteristica che 

preso un qualsiasi 

nodo la differenza di 

altezza dei due 

sottoalberi differisce al 

più di uno. L'altezza è 

la più grande distanza 

tra la il nodo e le 

foglie, in termini di 

livelli. Per la natura 

ricorsiva dell'albero si 

può considerare la 

radice anziché un nodo 

qualsiasi proposto 

nella definizione. 

Un albero siffatto 

garantisce ricerca, 

eliminazione e 

inserimento con una 

complessità 0(lg(n)). 



Ma passiamo al codice. Definiamo una classe in 
modo tale che possa essere in futuro facilmente 
ampliata con i metodi, che sono tanti, per la mani- 
polazione degli alberi. Ecco una idea: 

// Classe albero 
class albero 

{ 

public: albero(); 
albero(char*); 



^alberoQ; 



void aggiungi(char*); 



void postordineQ; 



void preordineQ; 



void inordine(); 



bool ricerca (char*); 



private: 



struct nodo 



{ 



char *info; 



struct nodo *dx; 



struct nodo *sx; 



>; 



struct nodo *tree; 



void agg(nodo* &, char*); 



void postordinepriv(nodo*); 



void preordinepriv(nodo*); 



void inordinepriv(nodo*); 



void cerca(nodo*, char*, bool &); 



>; 



Fin qui troviamo la definizione "minima" della 
classe. Valuteremo anche gli interessanti aspetti 
forniti dall'applicazione della OOP. Il nome della 
classe è albero. Rispetto ad essa si trova una parte 
privata, costituita dalla struttura fisica dell'albero, 
e da alcune funzioni di base e una parte pubblica 
che mette a disposizione del programmatore i 
metodi per la manipolazione dell'albero. La strut- 
tura è costituita da un elemento di base che è il 
nodo fatto di una parte informativa e due puntato- 
ri, uno destro (dx) e uno sinistro (sx) al nodo stesso. 
Inoltre, è presente il puntatore tree al nodo, con 
esso si identifica la struttura fìsica albero. Le tre 
funzioni private postordinepriv, preordinepriv e in 




Sono alberi generali con grado 
qualsiasi che seguono precise ca- 
ratteristiche. 

Sia A un B-Albero costituito dalle 
seguenti parti: 

• radice(A), il nodo che identi- 
fica la struttura e da cui di- 
scendono tutti gli altri nodi. 

• x, un generico nodo che può 



contenere da t-1 a 2t-1 chiavi. 
Fa eccezione la radice che può 
avere anche solo una chiave. 

• foglie, le foglie sono partico- 
lari nodi terminali tutte allo 
stesso livello. 

Vengono usati nella indicizzazio- 
ne dei file per sfruttare appieno 
il metodo l'accesso diretto ai file. 



ordinepriv realizzano ricorsivamente le ricerche 
sull'albero. La loro implementazione è riportata di 
seguito. Le altre funzioni si occupano di altrettanti 
aspetti di base come l'aggiunta di un elemento nel- 
l'albero e la ricerca. Tra le parti pubbliche vi sono 
oltre ai costruttori e distruttori le funzioni per ac- 
cedere alla struttura. Per cui si hanno a disposizio- 
ne: metodi per esplorare l'albero, che nella loro 
implementazione fanno riferimento ai corrispon- 
denti metodi privati; metodi per la ricerca e altri 
per l'inserimento. Di seguito sono riportate le rela- 
tive implementazioni. Analizziamo dapprima i 
costruttori e i distruttori. 

// Implementazione dei costruttori e dei distruttori 
albero: :albero() 

{ 

tree=0; 



albero: :albero(char *messaggio ) 



{ 



tree=new nodo; 



tree->info= messaggio; 



tree->dx=0; 



tree->sx=0; 



>; 



albero: :~albero() 



{ 



delete tree; 



>; 



I due costruttori generano il nodo radice. Il primo 
è senza parametri e si limita a puntare la struttura 
tree a (analogamente si poteva usare l'identifica- 
tore NULL). Il costruttore con parametro colloca 
nel primo nodo opportunamente allocato (con 
new) il messaggio (relativo parametro) nella parte 
informativa del nodo. Il distruttore libera la memo- 
ria con delete. Esaminiamo adesso come si possa 
aggiungere un nodo, in modo che l'albero rimanga 
sempre ordinato. Tale ordinamento preserva quin- 
di le caratteristiche di albero di ricerca. 

// privata 

void albero: :agg(nodo* &nod, char* mess) 

S 

if (nod = = NULL) 

{ 

nodo* p=new nodo; 
p->info=mess; 
p->dx=NULL; 
p->sx=NULL; 
nod = p; 

} 

else if (mess<nod->info) agg(nod->sx,mess); 
else if (mess>nod->info) agg( 
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nod- 


>dx, 


mess); 


}; 


//pubblica 


void albero: 


:aggiungi(char* 


messaggio) 






{ 


agg(tree 


messaggio); 








}; 



{ inordinepriv(nod->sx); 



cout<<nod->info<<"\n"; 



Il metodo pubblico semplicemente richiama il 
corrispondente privato specificando il messaggio 
da inserire e l'albero (tree che è la struttura priva- 
ta) a cui fare riferimento. Questo passaggio con- 
sente di fare riferimento alla struttura solo nella fa- 
se privata. Ciò è necessario per potere applicare la 
ricorsione. Nel metodo pubblico, come le elemen- 
tari regole di programmazione ad oggetti (OOP) 
consigliano, non apparirà la struttura albero su cui 
si sta facendo l'operazione. Tale metodo è stato 
usato anche per le altre funzioni ricorsive di visita 
dell'albero. In agg si richiama ricorsivamente la 
funzione sul sottoalbero destro o sinistro a secon- 
da del risultato della comparazione tra il messag- 
gio e l'elemento informativo chiamato. Nella serie 
di chiamate ricorsive ad un certo punto ci si imbat- 
terà in una foglia che non ha quindi figli. Qui viene 
allocato un nuovo nodo e collegato al nodo padre. 
Con il controllo anche sull'else si evitano di dupli- 
care stesse informazioni. In altre parole una strin- 
ga non si può presentare nell'albero più di una vol- 
ta. Da notare la presenza nella funzione agg del 
simbolo di reference & che consente di trattare il 
parametro associato di tipo variabile, in modo da 
stabilizzare il suo cambiamento dell'albero. 
Esaminiamo le visite. 



void albero: :postordinepriv(nodo 


*nod) 


{ 


if (nod! = 0) 


{ 


postordinepriv(nod->sx); 


postordinepriv(nod->dx); 


cout<<nod->info<<"\n"; 


}; 


}; 


void albero: :postordine() 


{ 


postordinepriv(tree);}; 




void albero: :preordinepriv(nodo 


*nod) 


{ 


if (nod!=0) 




{ cout<<nod->info<<"\n"; 


preordinepriv(nod->sx); 


preordinepriv(nod->dx); 


}; 


}; 


void albero: :preordine() 


{ 


preordinepriv(tree); 




}; 


void albero: :inordinepriv(nodo * 


nod) 


{ 


if (nod!=0) 





inordinepriv(nod->dx); 



>; 



void albero: :inordine() 



{ 



inordinepriv(tree); 



>; 



Si implementano naturalmente in modo ricorsivo. 
Si differenziano dal punto in cui viene posta in out- 
put la parte informativa. Ad esempio, per la vista 
preordine si ha prima l'output e poi la chiamata 
ricorsiva ai due sottoalberi sinistro e destro. Infine, 
esaminiamo la ricerca in modo da chiudere il cer- 
chio rispetto ad una ricerca fatta su un vettore or- 
dinato nel primo paragrafo. 

// Ricerca nell'albero 

void albero: :cerca(nodo* nod, char* mess, bool &tr) 

{ if ((nod! = 0) &&(!tr)) 

if (nod->info= = mess) tr=true; 
else if (mess<nod->info) cerca( 

nod->sx, mess, tr); 
else cerca(nod->dx, mess, tr); 

}} 

bool albero: : ricerca (char* messaggio) 
{ bool trovato =false; 

cerca(tree, messaggio, trovato); 

return trovato; 
} 



Anche qui si ha una procedura ricorsiva cerca. Si 
termina la chiamate delle chiamate ricorsive 
quando si raggiungono tutte le foglie quindi nodl-0 
risulta falso oppure quando trovato (paramentro 
tr) è vero. Nella condizione opposta, si rimane nel- 
la procedura. Si controlla poi se la parte informati- 
va è uguale al messaggio, in tal caso si setta a vero 
la booleana tr. Altrimenti si esplora il sottoalbero 
sinistro o destro a seconda del risultato del con- 
fronto. 



CONCLUSIONI 

Gli alberi sono un fondamentale strumento nelle 
mani del programmatore. Costruire una classe 
albero arricchendola dei metodi che possono ser- 
vire per il particolare uso che ne può scaturire è un 
utile esercizio. La prossima volta affronteremo 
l'importante estensione ed evoluzione degli alberi 
binari, quelli bilanciati. Si tratta di strutture dati 
più difficili da trattare ma che garantiscono note- 
voli performance nella manipolazione e ricerca 
delle informazioni. 

Fabio Grimaldi 
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ALBERO SPLAY 

Uno albero splay è un 
albero per ricerca 
binaria bilanciata con 
la proprietà, che gli 
elementi che vengono 
accessi più 
frequentemente, si 
trovano più vicini alla 
radice, di modo che la 
loro ricerca duri meno. 
Per ottenere questa 
proprietà, si espande 
(in inglese splay) 
l'albero in modo che 
ogni chiave cercata, 
venga spostata alla 
radice attraverso delle 
rotazioni. Queste 
rotazioni oltre a 
portare il nodo cercato 
alla radice, accorcia la 
distanza tra la radice e 
tutti i nodi che si 
trovavano tra il nodo 
cercato e la precedente 
radice, di circa la metà. 
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